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ABSTRACT 


This thesis presents the design and implementation of a 
Pome waro PECtocol for the VAX-11//30, under the VMS cper- 
ating system, to allcw message and file transfer to and from 
the INTELIEC MDS system, under CP/M-80 operating system, via 
the Ethernet local area network. 

The design cf this software protocol is based on the 
protcccl hierarchies where the network is organized as a 
series of layers or ievels, e¢ach one build upon its prede- 
cessctr. TLNempUErOscurOr Gach layer §:5 to offSr . certain 
services to the higher layers, shielding those layers fron 
the details of hew the cffered services are actually 
implemented. 

With this design concept, the desired softwares protocol 
will be transportable in the sense that it can be used by 
different kinds Of computer systems Wie) minimal 
modifications. 

The Ethernet local ar2a network is also designed in this 


samé highly structured way. 
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A. DISCLAIMER 


Many terms used in this thesis are registered trademarks 
GE commercial products. Rather than attemp > to cite @each 
individual cccurrence of a trademark, all registered trade- 
Macks aproearing in this thesis will be listed belcw, 
meemeewlng the firm helding the trademark: 


MTEL Cerporation, Santa Clara, California 
TNIELE2S MSS 
Multibus 


DIGITAL Research, Pacific Groves, California 
CE/M-80 


INTERLAN Corporation, Chelmsford, Massachusetts 
NI1010 Unitus Ethernet communications ccntrecller 
beard 
NI3070 Multibus Ethernet communications ccntrcller 
Beard 
NS2030 VMS device driver and NI1010 diagnostic 
pregram 


DIGITAL Equipment Corporation, Maynard, Massachusetts 
VAX- 14/7/30 “Mani cenputes 
VAX/VMS operating system 


Be GENERAL DISCUSSICN 


This thesis presents the design and implementaticn of 
Pomewar> ELCcocol Ecr the VAK-11/780, under VMS operating 
sys ten, <o allcw message and ‘f:il¢ transfer to and from 
INTELLEC MDS system, under CP/M-80 operating svstem, via 
Ethernet local area network. 





The Ethernet board is the product of Interlan ccempany 
which has produced the hardware and software technology 
needed tc connect several makes of computers to the network. 
All ccmmunications between host computers are made through a 
coaxial cable which has a 10 megabit per second data commu- 
nications rate. The Ethernet design is based on a highly 
Structured protccol where the network is organized as a 
series of layers or levels, ¢ach one build upon its prede- 


céSScr. The purpose of each layer is to cfifer certain 


A 


services to the higher layers, shielding those layers from 
the details cf hcew the offered services are actually imple- 
mented. 

This cencept of design yields a lot of advantagés in 
develcping software protecol such that it can be used by 
different computer systems with the minimum of modifica- 
tions. It is anticipated that the software protocol designed 
will re general in nature in order to be used with cther 
computers using different cperating systems with minor 
changes. The specific goals of this thesis are discussed in 


Miemncxt Section concerning the background of the project. 


C. BACKGRCUOND 


The AEGIS weapons system Simulation project currently 
boang  ccnducted at the Naval Postgraduates School is 
attempting to determine the feasibility of replacing <he 
larger and relatively expensive main frame computer, the 
Maen), WIth a system of 16 or 32 bit micro ccmou~ 


a 


Several sigrificant real-time functions of the AEGIS weapons 


c 


system are to be duplicated with associated data, npu 
emieng, and supporting functicn so that a sest ee can 
re examined whose performance emulates that of the actual 
system. [Ref. 1.] 


10 





Since the AEGIS weapons System Simulation oprceject 
involves many micro ccmputers and since all of them o 
real-time system, the speed of data communications bétween 
any two ccmputers is very crucial. Thus, a hiaqh-spe¢eed means 
of communication is needed. 

Ethernet local area network is considered +o be the 
solution rFecause of its capability of permitting 10 megabit 
rer seccnd data communicaticns between stations seperated by 
Memeo 25C0 meters. Iwo NI3010 Muitibus Ethernet communica- 
tion cecntreller toards and a NI1010 Unibus Ethernet ccmmuni- 
caticn ccntrcller bcards were purchased and implemented in 
INTELLIEC MDS systems and VAX-11/780, under the VMS operating 
system, respectively. An NS2030 device driver and an N1I1010 
diagnostic program are also implemented in the VAX. 


The specific goals of this thesis are: 


1.To design and implement software protocol cn the 
VAX/VMS such that it would be able to communicate (transfer 
messages and filés) with the INTELLEC MDS system, under the 
CP/M cpéerating systen. 


2.To be used as a guideline in designing scftware 
proteccls, especially when there is a need to communicate 
bstween VAX/YMS and cther systems which use different cper- 
ating systems such as ISIS-II. 


D. STRUCTURE OF THE THESIS 


Chapter I presents a general discussion of the larger, 
Sages Cticrt of which this thesis is a part. It alse gives 
@agenerail discussion of the background work of the AEGIS 
weapons system Simulation project and the need of the 
Etheznet local area network which leads to this thesis 


research. 


11 





Chapter II addresses the overall design philosophy of 
eilemsCrcwere pretocel which will be used in the VAXxsVMS. 
Beoeoccl £0r a lecal area network is discussed in detail to 
include the relationship to the ISO open system interconnéc- 
tion model. The design issues for the layers ar2 enumerated 
to be a step-by-step guide in designing the protocol. 

Chapteéer III discusses the Ethernet Local Area Network, 
concise Ethr SEccat ica tion, and the NI1010 Unibus 
Chur Ollorercana, 

Chapter Iv nr the detaiied design of the software 


Ethernet 


P=o-ccci tc include the use of the NS2030 Devics Driver, how 
Ethernet Eoard and thé Device Driver take care of the design 
issues fer the layer mentioned in Chapter II, and steps in 
developing the application layer protocol. 

Chapter V summarizes the testing of the implemented 
software protocol and describe its capabilities. Suggesticns 


are alse given fcr future research and modification. 





II. BASIC DESIGN CONCEPTS 


ie ERCTCCOL POR LOCAL AREA NETWORK 
1. Eackgroun 


A set of protcccls specifies how nodes can communi- 
cate cver nétworks. Frctccols are the precedures and conven- 
tions used *0 regiment the event progression required for 
crderly, mutually understood interaction pecween processes. 
Fretocols are developed to satisfy qualitativ2 and gquantita- 
tive reguirements fcr process interconnection. A primary 
qualitative requirement is the "useful" work aes5 “func= 
tionally) to be provided by the protocol. Other qualitative 


requirements inciude: 
a) .flexibility (to accommcdate new uses and features) 


b).ccmpleteness (tc properly respond to all reléevant 


HecwOrk conditicns) 
c).deadlock avoidance/backout nechanisms 
d) .synchrecnization mechanisms (for interprocess control) 
e) .errer detection and recovery 
£).ktuffer cverflow avoidance 
g) .tessaqe sequencing assurance 
h).duplicate message detection and récovery 


MeerermMeance (tO Llatplement ¢he orotocol uniformly through 


the lecal area retwork) 
j) -priority mechanisms 


k) -acccunting mechanisms 


13 





1) .security nechanisms 

m) .message delivery guarantees 

n).data ccde/fcrmat transformations 

o) .computer equipment feature compatibility 

p) .cperating system feature compatibility 
q@).ccmmunicaticns network feature compatibility 


Net all of thes2 requirements are cf equal impor- 
Geamee for €ach protocol lmplementation. FOr exXamie bo, a 
rrotccol might inhabit a local area n2twork node environment 
eenmttqured into any of the following topologies or hybrids 


of these tcrologies: 


a) star topology - a centralized copology in which lises 
ccnverge tea central point or ooints (see Figure 


Beel) sthas tcpolegy is alse called hierarchical or trea. 


b).mesh tcpology - nodes are connected in an arbitrary 
pattern; ¢ach nod@ can have multiple paths to cther 


nodes. 


emeeing tcpoleogy - the communications path is a loop with 
each nede connected to exactly «wo other nodes ina 


given loop. 


d) -kus topology - the nodes are connected along line 
segments; this tepology is commonly found in Local area 
networks with a shared transmission channel such asa 


catleée-kus. 


Typically, routing rotoccls for mesh topologies are much 
fememcourplex than reuting protecols for the other tcpolo- 
dies. Thus, other pfrotocel requirements, such as nessage 
delivery guarantses and message sequencing assurance, may bé 


influenced ty the tecpcelogy chosen. 
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Figure 2.1 Local Area Network Topologies. 
Cuantitative requirements for protocols include: 

ajthrcughrput - the volume of information that must be 
transferred during the peak pericd. This velume is 


usually characterized by mean message length in octets, 
the distribution of message lengths, and by the arrival 


tate cr messages. 





b)delay - the mean and maximum delay that the pretoc 


O 
will add tec precess responsiveness during the peak 


period. 


c)ccst - maximum acceptable recurring and necnrecurring 
costs associated with the installation of a pretocecl in 


a local area network. 


Reprerocel “tay perterm functions at the communica- 
tion link level or at apvplication process level. Of rrimary 
concern te lecal area network application developers are the 
application level protocols. Some of the protocols which 
Might ke ccensidered elementary to local area network devel- 


opments are discussed below. 


2. Application subsystem perspective of elementary 





The need fer anumber of e2lementary high-level 
rrotocols providing various types of services is apparent. 
Three main groupings of such protocols may be defined: 
applicaticn-criented, executive-oriented, and network- 
induced. The motivation for this classification is the 
perspective of distributed systems as extensions of the 
Single-system environment. The goal of elementary protoccls 
is ¢o extend the array of system utilities, programs and 
operating system services that are available ona single 
system to the total IlIccal area network. Hence, develooment 
of alementary local area network protocols is a basic step 
in eévclving high-level operating systems for local area 


networks. 
ae Applicaticn-Oriented Protocols 


Aopiagatscn-ori1entea protocols are defined tc be 
interprccess communication rules and data formats which 


extend the commonly used svsten programs (languages, 


— 
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Sa22ors, libtary, etc.) of ome node, to anh applicatior 


Ee@ecess In another ncede. Such protocols may include: 


ae rhe Transfer - allowing a process in one node to 
access files on another node as though the process wers 
EXecutang in that ned@, Simidar to general system util- 


ities that support media conversion with and withcut 


blocking changes, fermat changes, namin changes, 
etcetera. 
2).-£ditcr - allowing a process in one nodé to store, 


medify and retrieve text information ina file at 
ancther node. Preferably the protocol is implemented to 
a specification consistently applied a+ ¢ach node on 


the network. 


Syercomprzis = allowing a process in one rode to produce 
executable prcgrams at another node. The pretocol 
ingplements a network wide source and object ccde 


library and linkage editor. 


4) .Exscute - allowing a frocess in one node to invoke a 
rrogram at another node by module name, to supply 
parameters to the program and to receive program output 
and system notice messages at the sending local area 


netwcrk node process. 


5) -Debug - allecwing a process in one node to dynamically 
debug a program at another node. Preferably allows an 
application process distributed among two or more local 


area network nodes to be debugged interactively. 
b. Executive-Oriented Protocols 


Executive level protocols are defined +0 he 
interprocess communication rules and data formats which 


extend che cperating system services (resource allocation, 


VW 





feveeece Cr Pp=cgram Servics, Monitor services, etc.) of one 


node to an applicaticn process in another node. 


1).Command Prectoceil - allowing commonly used operating 
evewen Services (ASSIGN, PRINT, TIME, STATUS, etc.) in 
each nede cf a network to be invoked uniformly by a 


precess in anotker nede. 


2)-Wartual Scrolling Terminal Protocol - allowing a 
frecess in one ned? tc communicate with a process in 
ancether node as though the receiving process were a 

oa 


ling output device such as a printer or teletype. 


k? 


3) -Wirzual Screen TZerminal Protocol - allowing a process 
in ore node to communicate with a process in ancther 
node where the receiving process operat2s on a randomly 
addressable collection of two dimensional pages of *=ext 


using predefined functions and transmitted variables. 


4) .Virtual Graphic Terminal Protocol - aliowing a precess 
in cne node to communicate with a process in ancther 
node where the receiving process operates on a randomly 
addressable collection of two or three dimensional 
figures and two dimensional text using predefined func- 


ticns and transmitted variables. 
GC. Network-Induced Protocols 


Network induced protocols are defined to be 
interprocess communication rules and data formats which 
facilitate the operation of executive level and application 


level protocols in a local area network. 


teeexrwork Endpoint Declaration Protocol - provides the 





mechanism fcr a local area network node to establish or 
dis¢stablish addressable network ports in a directory 


thereby allowing qualirfied processes in other nodes to 
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become associated with processes assigned to ¢ 
Dp 


Tie er ctocel Might serve normal and 
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processes in the application space as wall a 


(n 
a 
x 


O 
control functions within the operating system. This 
pretocel provides a mechanism +0 identify “well known" 


frecesses ina network directory. 


Qeencawcrk Access Avcthorizeation Protocol - allewing 2 


a) 


process +o gain access *9 another process in tne 
mMecwork. Includes icg-on/log-off support to end users 
as well as general precess interconnection authoriza- 
aa OT « PMterfaced with network Security and. prpravacy 


Manacement information systems. 


~~ 


3) .Network Directory Servic 


‘ — 
= = oi 


ek PEOLOCol = dl lowing la Yeceess 
to request information about a node, another process or 
an end user. May also support custom menu services for 
each network usér to promote the impression of a Single 


intecrated systen. 


volmououccol = allowing “a DECCess 1m One 


node «to establish an association with a process in 
ancther node and tc exchange messages ina virtual 
Circuit or datagram mode. Usually implemented as an 


augmentation to the operating system of a network node. 


BS).einterrrocess Synchronization ~ providing a mechanism 
fer twce or more frocessesS in two or more nodes tc coor- 
dinate asynchrenously executing fUnC=LOnS. thes 


mime cOCcec. Could undemlise the viscual terminal ccntrol 


mace CGC: 
6).Nezwork System Control Protocol - providing the 
mechanism for establishing "built-in" maintenance and 
security subsystems ina local area network enviren- 
t 


tc. It is envisioned that performance, mnaintenance 
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and security checks should permeate the local area 
network software as well as hardware systen. Eucs 
BEcCt CGC lmidcalitetesS  Unitied spseci i: cation: Of perfor 


mance, maintenance and security related functions. 


Be PROTCCOL HIERARCHIES 


To reduce their design compiexity, most neézworks are 
erganized asa series of iayers or levels as mentioned 
earlier. 

Layer n On one fachine carries con a conversation with 
lay2r ncn another machine. The rules and conventions used 
in this ccnversation are collectively known as thse layern 
Mace acol, aS illustrated in Fig. 2.2 for 2a seven-ilayer 


network. The entities comprising the corresponding iayers 
cn different machines are called peer processes. In cthe 
words, 1t is the peer precesses that communicate using 
Brocccol. 


In reality, no data are directly transferred from layer 
non one machine to layer n on another machine (except in 
the lcewesst layer). Instead, each layer vasses data and 
eone.cl infcrmation to the layer immediately below it, until 
the lowest layer is reached. + the lowest layer there is 
physical communication with the other machine, as opposed to 
the virtual communication used by the highest layers. In 
Fig. 2.2 virtual communication is shown by dotted lines and 


eiysacal ccmmunicaticn by sclid lines. 


Between each pair cf adjacent layers there is an inter- 
mace. The interface defines which primitive operations and 
Services the lower layer offers to the upper one. When 


network designers decide how many layers to include ina 
network and what each one should do, one of the most impcr- 
tant considerations is having cleanly defined intefaces 


between the layers. Having cleanly defined interfaces, in 
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Figure 2.2 Layers, Protocols, and Interfaces. 


Moen, requires that each layer perform a specific ccllection 
Seeweil urdéerstocd functions. In addition to minimizing the 
amount crt informaticn that must be passed between layers, 
clean cut interfaces also make it simpler to replace the 
implementation of one layer with a completely different cne, 
because all that is required of the new implementaticn is 
that it cffers exactly the same set of services to its 


upstairs neighbor as the old implementation did. 
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e set of layers and protocols is called the network 
cture [Ref. 2. J. Pie Spec2flcazion Of “ene architec- 
ture must contain encugh information to allow an implamente 
to write the program for ¢ach layer so that the program will 
correctly otey the appropriate protocol. Neither the details 
Oe the inplementaticn nor the specification of the inter- 
faces are part of the architecture. In fact, 1% is not even 
necessary that the interfaces on all machines in a network 
ke the same, provided that ¢ach machine can correctly use 


meee the frotccols. 


C. DESIGN ISSUES FOR THE LAYERS 


Some cf the key design issues that occur in comfuter 
networking are present in several layers. The following are 
some of the common problems that must be repeatedly dealt 


with in tke design of the different protocols. 


1.Every layer must have a mechanism for connéction estab- 
lishment. Since a network normally has many computers, 
scme of which have multiple procéssors, some méans is 
needec for a precess On one machine to specify who it 
Wants to talk to. In any layer where there are multirle 


destinations, addressing is needed. 


bo 
. 


Closely related to the mechanism for establishing 
ccnnections acrcss the network is the nechanism for 


terminating them once they are no longer needed. 


n er set cf design decisions are the rules for data 
transfer. Does data only travel in one direction, called 
Simplex communication, or can data travei in either 

EGrMen,meeetc noe Simultancously, called haift-duplex 
Unteerwon, Cr Can “hey travel in both directions at 
cence, called fuli-duplex communication? The pEetoO cel 


mus= also determine how many logical channels the 


ee 





Gomleceson cChoeercnas to, and what €héeir priorities 
are. Many networks provide at least two logical channels 
BempecChreetlicn, Che for normal data and one for urgent 


data. 


Mercer GCCNtLOl iS an importance issue when the pnysical 


Communication CitTCcuits are not perfect. Many) 2 ceer= 
ia 


Ho 


Mereetiug and GriC=-Ccorrecting ccdes are known, but bo 


ox 
@M 
t Se 
J 
1Q 


ends of the connection must agreéé on which cne is 


used. In additicn, the receiver must have some wa 


Wd 


@) 
ct 
~ O 
ta OF 


telling the sender which messages have been ccerre 


mecotved and Which have ncot-. 


Net all communication channels preserve the crder of 
messaces sent on them. To deal with a vossible loss of 
sequencing, the protecol make explicit previsicn for the 
receiver to allcw the pieces tc be put back togetner 


BLODSE LY. 


An issue ‘that cccurs at every level is how to keep a 
ast sender from swamping aslow recéiver with data. 
[here “are VaLrzous solutions <5 this and all of ‘nen 
anvolve some kind of feedback from the receiver te <he 
sender, either directly cr indirectly, about what tne 


mec=iver's Current Stcuatior is. 


Ancther problem that must be solved epeatedly at 
Meererent levels is the tnabilit of ali processé€s to 
accept arbitrarily long nessages. This leads to mechan- 


isms for disassemtling, transmitting, and then reassen- 


cling messages. 
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D. THE ISO REFERENCE MODEL 


is mcdel is clcsely based on a proposal déveloped by 


Th 
the In 


ternational Standard Organization (ISO) 235 a first 
step toward internaticnal standardiza*ion £ the varicus 
Beetocols. 


The Referercs Mcdel of Open System Interconnection has 


seven layers as shown in Fig. Z.3. 


-—-—---—- 


= 


Name of unit 
Layer exchanged 


Application protocol . 
Applica= 


7 Applica~ ee : Message 
tion tion 


Presentation protocol 






6 Presenta- PENS M ren Seng eats NY ade 0 eee i i i ne Presenta- Message 
tion tion 
Session protocol 
5 Session are ae en ee, Reese” Bae Wee eng igre S| ewe ee en Ao eg ee > ees = aren ght Message 
Transport protocol 
4 Transport - = = we = —- -— |= —~— | ZF CF Trl Kr lh Transport | Message 
Communication subnet boundary 







Internal subnet protocol 


2 Data link Data link —-— « Data link} Frame 





Network layer host - IMP protocol 
Data link layer host - IMP protocol 


| 


Physical layer host - IMP protocol 
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Figure 2.3 ISO Reference Model. 
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ine Prinewolkes that welS@ applied to azrive at tne seven 


layers are as follows: 


1. A layer should be created where a differen 


level cof abstraction is needed. 


2. Each layer should perform a well defined 


Paencticn. 


3. The function of each layer should be chesen 
With an eye toward defining internationally standardized 


meotccols., 


4. The layer boundaries should be chosen tc 


minimize the imformation flow across the interfaces. 


5. The number of layers should be larg? encugh 
meee distinct functicns need not be thrown together in the 
samé layer cut of necessity, and small e¢nough that the 


architecture does not become unwieldy. 


The seven layers, ‘from the lowest layer to the highest 


layer, ares 


1.Physical layer - The physical layer provides 
Nechanical, electrical, Eunctional and proceduzal 
characteristics to e¢stablish, maintain, and 
Scleaise pn yeleat CONNeectLONns {¢.G., Aata-ciscuzts) 
between lirk-entities. The physical layer provides 
for the transmission of transparent bit streams 
between data link layer protccols across physical 
connections which are permanently’ or dynamically 


established. 


2.Data Link Layer - The purpose of the data link 
layer is t¢ provide the furctional and procedural 
means to establish, maintain, and releas¢ one or 


mcre data links among network-entities. This layer 


2) 








masks the characteristics of the physical layer 
(such aS switched, multipoint, broadcast, polling, 


centention, etc.) from the network layer. 


3.Network Layer - The network layer provides func- 
ticnal and rrocedural means to exchange network- 
services-data-units between two transport-entities 
over a network-connection. It provides transrort- 
entities with independence from routing and 
Switching considerations, including the casé where 
a tandem subnetwork-connection ZS wIsed: The 
network layer protocol uses underlying data link 
ccennections to make network connections invisible 
2G tte Cid )spob-) 1d Ver ph eLOCOl. 


isieansvonct bayer - The eransport layer exists £0 
provide a universal transport service in assccia- 
ticn with the underlying services provided by 
lower layers. The LhalspOrGt-service || p=oOvides 
transparent transfer of data between s¢ssion- 
entities. The transport-service relieves theses 
session-entities from ny concern w 

a 


a 
detailed way in which reliable and cost 
di 


oe 


transfer cf data is achieve 


transpcert services are: 


- A connection-oriented service 
- A transaction-oriented service 


- A broadcast-oriented service 


The transpert service is required *o cptimize the 
use of the available communications services to 
provide the performance required for each cecnnec- 
tion between sessicon-entities at a minimum cost. 
To achieve cptimization, th2 global demands of ail 
CCMECULEGHEe EranSPoOrt wSers and the transpcrt layer 


Resource Jimnitaset ons acre considered. 
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ZS -tO aSSist 2n the Support of the interacticns 
between cocrperating presentation-entities. To do 
this, the session layer provides services which 


are classified into the following two categories: 


a relationship and unbinding then. 


Dl SoeSsmene Da tOguewoer vices “= Cento ror 
data exchange, delimit and synchren- 
izing data operations between two 


presentation-entities. 


6.Presantation Layer - The purpose of the presen- 
tation layer is to provide the sét of services 
which may be selected by the application layer +o 
enable it to interpret the méaning cf the data 
exchanged. These services are for the management 
Stee ne “entry, ©xenange, display and. centre. of 
structured data. The presentation-service is loca- 
tion independent and is considered ~o be on tcp of 
the sessicn layer which provides the service of 
linking a pair of presentation-entities. I+ is 
through tke use of services provided by the 
presentaticn layer that applications in an oren 
Systems interconnection énvironment can communi- 
cate without unacceptable costs in interface vari- 
acai y, transformations or apolicat2on 
modificaticn. There are four phases of preseénta- 


“fom Layes CEOtOC Cc! Operation: 


a)Session establishment phase in which 


the connection is set up. 


ot 





k)Presentation image control phase in 
which the presentation options can be 
selected by values, by name, by crior 


agreement or by negotiation. 


c)Data transfer phase which controls the 
data structure access?s and perhaps 
executes Special purpose ‘transfcrma- 
ticns such as voice compression or 


data encryption. 


d)Termination phase 


the reference model of open systems interconnéec- 
t2on ) ce chi teceur €. PEGtOCOlS OF this layer 
directly serve the end user by providing the 
distributed information service appropriate +o an 
application, to its management and to the systen 
Management. Management of open systems intercen- 
nection ccmprises those functions reguired ¢t9 
Tne aces Maintains *cerMonacs iand teccred -daza 
cencerning the establishment of connections for 
data transfer amcng appvlication processes. The 
Gtnper  iayers eZls= only ©o6. Support this layer. 
Three categories of application layer fprotcccis 
are defined: 


a)System Management Protocols <- respon- 
Sr nleveer conc tOliing and Supbezyv2sing 
open systems (E.g., pap pOcc ise ba olen (2 
agvalo dir. 


byApplication Management Protocols - 
responsible for controliing and super- 
vising application processes (&.g., 


QeECeses CON czol) 3 
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c)System Frotocols - responsitie for 
executing information processing func- 
tions on behalf of an apolication 
process or user (€.g., electronic 


mail). 
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A. CWERVIEN 


Ethernet is one type of local communication netwecrk 


Warem makes use of coaxial cable as aémean to transfer data: 





Contention 
slots 


eerie [] Lesckee | 


Contention 
interval 


7 


Idle 


| 
| 
TIC 


Ge ae ai ea ee ae SE ee ee a ee sr ee ee em a ee 





Figure 3.1 Contention, Transmission, and Idle States 


All staticns in the Ethernet network monitor the cable (the 
ether) during their cwn transmission, terminating transmis- 


sion immeciately i£ a collision is detected. 


The Ethernet mechanism is mcdeled in Fig. 3.1%. At the 
Poe. Marked t, a station has finished transmitting its 
packet. Any other stations having a packet to send may now 


@eeeemoe. tc de so. Lf two or more stations decide to transmit 


(n 
}. 
= 


Tecanecusly, there Well be a collision. Each will detect 


the ccllisicn, abort itS transmission, wait a random period 


O 
th 
cr 
a 
=| 
( 
be] 


and then try again, assuming that no other station 
has started transmitting in the mean time. Ethernet will 
therefore consist of altérnating contention and transmission 
rericds, with idle rfericds occurring when all stations are 
quist. 
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B. CCNCISE ETHERNET SPECIFICATION 


ls Facket Fermat 


—------— 


— oS 


FRAME : } 
| rs DESTINATION SOURCE eens INTERFRAME 
" ADDRESS ADDRESS : SPACING j 


SEQUENCE 





eS oe 


e4-SITS 418-BITS 48-BITS 16-BITS 46-1500 BYTES J2-BiTSsS ~9.o NMICROSEC- 


a a oe eee 150 aid 


— 


@m 2 we 4 So ae aes ee -  e  E Ss  e  e eee  eee 


Figure 3.2 Ethernet Packet Format. 


A staticn must ke able to transmit and receive packets on 
the ccmmcn coaxial cable with the indicated packet fermat 
and spacing. Each packet should be viewed as a sequence of 
8-bit bytes; the least significant bit of each byte 


fSeta=eting with the preamble) is transmitted first. 


a) .Maximum Packet Size: 1526 bytes(8 byte preamble + 14 


eb a a = ae ae Gee ee 


Eyce header + 1500 data bytes + 4&4 byte CRC) 


b) .Minimum Packet Size: 72 bytes (8 byte preamble + 14 


= Do ae ee eS a aE aE SS 


byte header + 46 data bytes + 4 byte CRC) 


eyeeeccamble: This 64-bit synchronization pattern contains 


ae ES ASS ES SS es 


eecernating °s and) 0°%s,;" ending with two consecutive 


d) .Léstinaticn Address: The 48-bit field specifies the 
a (S) to which the packet is being transmitted. 
Fach station examines this field to determine whether 


t 
Pe snemld aecepe the packet. The fitst bit transmi==sd 
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th 


Qi 


mudiGaees sene ctype Of qddtress. if it isa 0, the fiel 
contains the unique address of the one destination 
Seaeton., Lh 2+ 25 aod, the field specifies a logical 
GeGubeet Leclpients; a special case is the broadcast 


(all stations) address, which has all t's. 


e).Scurce Address: This 48-bit field contains the unique 


dddzess Of “the station that iS <ransmitting the packet. 


emer l cide ines 16-bit zat1eld “is used sor tdenczsty the 
higher level prctocol type associated with the packet. 


It determines hew data field is interpreted. 


g) Data Field: The field contains an integral number of 
bytes ranging from 46 to 1500. (The minimum ensures 
that valid packets will be distinguishable from ccili- 


Ssicn fragments.) 


Wperacket Check Séquence; This 32-bit field contains a 


redundancy check (CRC) code, defined by the generating 
pelynomial: 


G {x) = x324¢y 264 ye3S¢exy22e yl GOtyley-yil 


Xe Orr LS Ke tx + | 


The CRC covers the address (destination/source), type, 
esti- 


4 
~ 


and data fields. The first transmitted bit of the de 
Naticn field is the high-order ‘term of the message 
rciyncmial to be divided by G(x) producing remainders 
Rex. «6 RS hagh=-crder ferm of R(x) is the first trens- 
Mitzed bit of the Packet Check Sequence field. The algo- 
rithm uses a linear feedback register which 1 

ata bit is trans- 


preset to ali 1's. After the last 
+ 


a d 
Mitted, the contents cf this register the remainder) 


are inverted and transmitted as the CRC field. Attc= 


receiving a good packet, the receiver's shift register 
ccntains 11000111 00000100 11011101 071111011 (oslo 
7X9). 





Detention Packet Spacing: This spacing is 9.6 microse- 


cond, The minimunr time that must elapse after one <‘*ran- 


smissicn before another transmission may begin. 


j) -Round-Trip Delay: The maximum end-to-end, round-trip 


delay fer a bit is 51.2 microsecond. 


k) .Ccllisicn Filtering: Any received bit sequence smalier 


um valid packet (with minimum data field) 
S 


a colliszon fragqmen=. 


The control procedure defines how and when a hest 
Staticn may *rasmit packets into the common cable. The key 
purpese is a fair resclution of occasional contention anong 


tranesRizting stations. 


a).Defer: A staticn must not transmit into the coax cable 


when the carrier is present or within the mininun 
Ss 


packet spacing time after the carrier has ended. 


Mmeeicansmits A Station May transmit 1f it is not deier- 


mong. tc May CCRtInuS tO tCranSmMit Until either the. end 


cf the packet is reached or a collision is detected. 


mmenecrts Tf a colijisiton is detected, =ransmission of the 


racket must terminats, and a jam (4-6 bytes cf arbi- 
trary data) is transmitted =o ensure that all cther 


Ba@tiecipants an the collision also recognize its occur- 


eetnce « 


d) .Retransmit: After a station has detected a 


c 
and abcrtéd, it must wait for a random rcetransmiss 


delay, defer as usual, and then attempt to reatrans 
the packet. The random time interval is compute Ss 


d 
the backoff algorithn (below). After 16 retransmission 
Ss 


n 
attempts, a higher level (e.g. software) deci 
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made tc determine whether to continue or abandon the 


effort. 

e).Backoff:; Retransmission delays are computed using the 
Truncated Binary Exponential Backoff algorithm, with 
the aim of fairly resolving contention among up to 1024 
stations. The delay (the number of time units) hefcre 


is a uniformly distributed randon nun 
Paemeo to 2 £or O<nsi0 (n = 0 1S the original atzenp 
For attempt 11-15, tie 1 ncer Val hs. eSeunceted “and 
BeMains 2t@0 towml0Z3. The wWaet of time for ths = 


i 
Mission delay is 512 bit times (51.2 micros¢cond). 
foe Channel Encoding 


Manchester encoding is used on the coaxial cable. It 


has a 50% duty cycle, and insures a transition in the niddle 
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Figure 3.3 Data Rate Scheme. 
eeemevesy Fit cell ("data *ransit: 


mem ci+ cell contains «he c 


O 
maemseccnd half contains the 
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a. Lata Rate 


Data Eate ts 10 Mbit/sec = 100 nséc big cell + 


5. Carries 


The presence of data transitions indicates ‘thar 
carrier is present. If a ‘transition is not s#én betwean 


fees and 1.25 bit times since the center of the last biz 


Geli, then carrier has been lost, indacating the end of 32 
packet. For purposes of eee tt carrier means any 
pemeevity cn the cable, independent of being properiy formed. 


Beecifically, it is any activity on either receive oz ccelli- 


Sion detect signals in the last 160 nsec. 
6. Ccax Cable 


meeumpedance: 50 chms £ 2 ohms (Mil Std. Civy-£}. This 
impedance variaticn includes batch-to-batch variations. 
Feriodic variaticns in impedance of upto + 3 ohms are 


Fermitted along a single piec2 of cable. 


b) .Cable Loss: The maximum loss from one end of a cabie 
segment to the cther end is 8.5 db at 10 MHz (eguiva- 


lent #c 9500 meters of low loss cable). 


a) 


Slee ont.slding: The physical channel hardwaze must oper 
ar ambient field of 2 voits per meter from 10 MHz to 
MHZ and 5 volts per meter from 30 MHz to 1 GHz. The 
ld has a transfer impedance of less than 1 niliichn 
per meter over the frequency range of 0.1 MHz to 20 MHz 


(exact value is a function cf frequency). 


MeeGr@und Connecticn: The coax cable shield shall ncz be 


Gommececa |) tO “any DUitading ofr AC ground along- its 
length. If for safety reasons a ground connecticn of 


the shield is necessary, it must be in only cne placa. 
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Cablewwnten car be "used *" che standard <=ap. Cirhes 
cables may alsc be used, if they are not *5 o3F U 
With a tap-type transceiver (such as used with conn 
tcrized transceivers, or aS a section between sect 
tc which standard taps are connected). 

@=n~er Conductor: 0.0355" 9 dianetver. soitd “:n7=d cocce 

Core Material: Foam polyethylene or foam teflcn Ft 

mom O.D.: O22e2 "Srna simon 

Sie ld: 02326 "Snaxrnum, Shield O.D. 

Jacket: PVG SOL eer honm PEP 

Senet O.f. ; Oa 405 


$$$ $$$ $$ $$$ 


Coax Cable Segment (1 electrical segment) 


eee ge 


Coax Cable Section El 
hc ee i 


Female-Female Female 


Adapter (Barrel) Cable Transceiver 


Connector 


Siens>. This Specifies the dimension or 3 


: 


Terminator Tap : Connector ——— Terminator 
eee Connectorized 
a) 


Eee Host 
Station en a ane Station 

Transceiver Connector 

Cable 
o here Sy ee a a en a a ee ae re aa 

Figure 3.4 Coax Cable, Connectors, and Transceivers 
ee ccax Sennecross and Terainacors 
Ccax cables must bé terminated with nale N-series 

connectors, and cable sections will be joined with feraie- 
female adapters. Cennector shells shall be insulated such 


Gi@eac  <Nhe COX, Shield is pretected from contact to building 
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grounds. A sleeve cr boot 1s accep*able. Cable segments 
should be terminated with a female N-series connector (can 
be made up cf a barrel connector and a male terminatcr) 
having an impedance cf 50 ohms + 1%, and able to dissipate 1 
watt. The outside surface of the terminator should also be 


insulated. 


8. Transceiver 


Up tc 100 transceivers may be placed cna cable 
segment nce closer than 2.5 meters. Following this placement 
tule reduces to a very low (but not zero) eprebability the 
chance that objecticnable standing waves will result. The 
details cf transceiver interface and coax cable interface 
can te fcundin Interlan's "Concise Ethernet Specificaticn" 
(Ref. 3]. 


C. NI1010 UNIBUS ETHERNET COMMUNICATIONS CONTROLLER 


1) .Data Encapsulation/decarsulation 
z) Carrier Sense Multiple Access/sCollision TLetected 


(CSMA/CD) transmit and receive data link management 


b).Etherne? Physical Channel Functions: 
1).10 Mbits per second data rate 
z) Lata enceding and decoding 
3).Channel access 


4) .Transceiver cable interface 


1).Tallies number of transmissions, receptions, errors, 


and collisions 


an 





1).16 Kbytes FIFC buffer for back-to-back frame recep- 
Ero 
2).2 Kbyte FIFO buffer for frame transmission 


3) .DMA transfers to/from unibus memory 


ttn 








aaa Diaqncstic saree 
1 


z) .Néetwork LED indicators 
3) .Fcwer-up confidence test 
u) .Pass/fail LED indicator 


5) .CLiagnostic software provided 


f).Cne Eex-Hight Beard: 
1).Fit one uwunibts SPC slot 


eee) DESCr2 pt ion 


The NI1010 Unibus Ethernet Communication Centreller 
Board is a single Heéex-height board ‘that contains all the 
Geta, ccmmunications centroller logic required for inter- 
facing DEC's family of VAX-11 and Unibus-based PDP-11 mini- 
SBamputess tc the Ethernet local area network. It performs 
the specified data dlink and physical channel functions, 
permitting Unibus-based systems to engage in transmission 
and recerpticn of data with ther Ethernet stations on the 
local aréa network with the speed of 10 Mbit per second and 
wich the maximum distance of 2500 neters. As shown in Figure 
Be >; she NI1010, when attached t0 a transceiver unit, 
provides a VAX-11 or Unibus~based PDP-11 a complete connéc- 


meem cntc the Ethernet local area network. 


See ktheret data link jayer functions 


a a a a oS ce = a ae ae Ee aa = 


Within the data link layer the NI1010 performs the 
specified Ethernet transmitter processes of Transmit Data 
Encapsulaticn and Transmit Link Management, and the Ethernet 
receive frocesses of Receive Data Decapsulation and Receive 


Link Management. 
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mEgqure 3.5 Ethernet Architecture and Implementation. 


a. Transmit data encapsulation 


roqgune 460) SNhOWS ene Stnerno:! Peane- Format for 


packet transmissions over the coaxial cable physical 
Channel. Fer receive synchronization purposes, «he frame is 


preceeded with a 64-bit preamble saquence and terminated 
wes hi a Nininum interframe spacing Deziod, "CE 926 


microseccnds 
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The Destination Address field specifies the 


Seae2on{(S) for which the frame is intended. The address 
value previded by the user may be either; 1jthe physical 
address of a particular station on the network; 2) a 
Multicast-grcup address associated with one or more 


stations; or 3)*he troadcast address for simultaneous tran- 


Dest .iSource 
Preambl Preamble | Dest. jSource| 
“faddr.| Addr.[7YP*l Data | CRC Ronee eet vecievata eae 
64 48 48 16 Field 32 64 48 48 16 | Field) ., 


| —— Minimum Packet Spacing 


| 


| 





L cre covers these fields 
G(x) 


—— ee cc I a RR lM I 
i A i EO ae AOD tee EE ee 


| 
| 
[ 





| 











Figure 3.6 Ethernet Frame Format. 


smissicn tc all staticns on the network. Tne: fies, bas. (Of 
the Destination Address distinguish2s a physical address 
rom a multicest address (0 = physical, 1 = multicast). For 
troadcast transmissicns an all one-bit pattern is used. 

The Source Address field specifies the physical 
address cf the transmitting station. To eliminate the pessi- 


a ah - i a vee - aw Y a tate 
bility of an addressing ambiguity on a network, associated 


with each NI1010 is a unique 48-bit physical address valus 
assigned tc it at the time cf manufacture. On transmission, 
the NI1010 inserts this value into the Sourcsa Address field. 
The «ype field is specified by «he user for use 

O 


by high level netwerk protccols. It specifies 
receiving station(s) how the content of the Data field is to 


ke interpreted. 
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The Data field may contain a variable number of 
data bytes ranging from a minimum of 46 bytes toa mnaxinun 
of 1500 ;Eytes. The NI1010 accepts less than 46 bytes from 
the user by automatically,inserting null characters to 
complete a 46-byte minimum frame size. 

The Frame Check Sequence (FCS) field contains 2 
32-bit cyclic redundancy check (CRC) value generated by the 
NI1010 during transmission. 


bk. Transmit link management 


4 
fv 
n 
t 
c+ 
tt 
- 
op 
o 


The NI1010 performs all Ethernet T 
Management functions required to successfully deliver a 
frame onte the network. These functicns include: 


e Carrier Deference; the NI1010 monitors the fhysical 
Channel and defers its transmission schould the channrel 


bepbusy carrying cther traffic; 


e Collisicn Detection; once the NI1010 has finished defer- 
mage tO the passing tratfic on the network, it proceeds 
With its own transmission. In the event that ancther 

station simultaneously kegan a transmission, a "cclli- 

Sicn" cccurs. The NI1010 detects this event and termi- 


nates 1%S transmission attempt; and 


mecca lisicn Backoff and Retransmission; when a transmis- 
Sion attempt has been terminated due to a collision the 
NI1010 attempts its transmission again after delaying a 
short random pericd of time. The scheduling of «ke 
retransmisSicn is determined by the Ethernet precess 
@arted  “frumcated binary exponential backoff". The 
NI1010 reports an error should it be unable to deliver 
its frame onto the network after 16 transmission 


attempts. 
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c. Receive data decapsulation 


When not transmitting a frame the NI1010 ccnti- 
nuously listens to the traffic being carried on she network. 
After synchronizing to the pr2amble sequence of a frame on 
the netwecrk, the NI1010 processes the Destination Address 
field through its address filter logic to determine whether 
cr net the incoming frame is intended for it. The NI1010 
contreller will only accept a frame from the network with a 


Destiraticn Address value that either: 


1) matches the fnysical address of the NI1010 toard 
itself; 

z)centains the breadcast address; or 

3)ma*tches one 6: the 63 


im Least “Group, ~leda.ca! 
Ss 


mulc 
addresses which the user may assign to the board. 


The NI1010 performs high speed multicast-group 
address reccgnition. Whenever a multicast-group Ilegical 
address is received cn the network, the NI1010 converts the 
frame's UWS-bit Destination Address field into a 6-bit table 
entry peinter through the application of a many-te-few 
Mapping called "hashing". It uses the resulting pointer to 
jook intc a table of valid multicast-group addresses tc see 
if the received address is one that the station should 
accept. 

For netwcrk management and diagnosis, the NI1010 
May be operated in a "promiscuous" receive mode. When in 
tnis mcde¢, the NI1010 disables its address rilter legic and 
accepts all undamaged frames passing on the naetwork. 

The NI1010 validates the integrity of a received 
frame ky regenerating the 32-bit CRC value on the received 
bit stream and comparing it against the CRC value found in 


the frame's Frame Check Sequence field. 
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d. Receive link management 


Since collisions are a normal occurrence in the 
Ethernet's cCSMA/CD link management process, the N1I1010 


receiver filters out collision fragments from valid fram2s. 


4. Eth¢ret physical layer 


unctions 


Pelee EES SD ee 


Ith 


Within the Ethernet Physical Layer the NI1010 
parftorms the electrical and DEOGedUral- speci eicatscns 
meawared fcr interfacing directly to a transceiver unit. 
Transmissicns and receptions take place at a 10 Mbits fer 


second data rate under half-duplex operation. 
a. During transmission the NI1010's physical 


channel functions include: 


t-- 


1) .Generating the 64-bit preamble sequence fOr au 
receivers on th¢ network to synchronize on; 

2) -Farallel to serial conversion of the frame; 

Syeecalcudeating a 22=bit CRC value and inserting it into 
the Frame Check Sequence field; 

4) .<Génerating a seéelf-synchronizing serial bit streéan 
thrcugh Manchester encoding of the data; and 

5) .Froviding proper channel access by detecting carrier 
frcem ancther station's frame transmission, and sensing 
the collision presence signal from the transceiver 
ay Lt < 


bk. The NI1010's physical channel functions during 
recerpticn include: 


1) .Manchester decoding the incoming bit stream into a data 


stream and a cicck strean; 
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EeesyMCRECRi Zing <6, and removal oy ae the 
sequence; and 
3) .Serial to Parallel conversion of the frame. 


5. Eerfcermance 


The NI1010 has been designed to offer high network 
perfcrmance while minimizing the service loads placed uron 
the hest Unikus systen. 

Serving to buffer the systam from the unpredictakl: 


mmeerarrcival times characteristic of network traffic, the 


Feartd has a FIFO (first-in, first-out) memery which can 
store up to 16 Kbytes of received frames. Because of <his 
extensive front-end buffering, few time-critical service 


requirements are impcsed on the host Unibus systen. 

Fer transmission, the NI1010 has a 2 Kbyte Trarsnmi« 
FIFO which permits the host to perform a one-time transfer 
of a frame. 

All data block transfers between the NI1010 and 
Unibus méemecry are performed under the control cf an onkoard 
Biaseccn<crcller. To maximize system performance duzing recep- 
On, the controller alilcws the user to oreload up to 
Sixteen different memory buffer address and byte count 


values fer CDMA of received frames. 


6. Extensive Diegnostic Features 


The NI1010 offers comprehensive network and bceard- 
level diagnestic tools which graatly simplify the precess of 
identifying a network communication problem. Mounted on the 
Seige, CL <zhe board are four network state LED indicatcrs 
which provide a visual indication of whether cr net the 
user's station is ccmmunicating onto the network. For a 
comprehensive station diagnosis, the user can exercise the 


mero 10'S cCcctmunicaticn facilities in ¢ither internal or 


Gy 
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Figure 3.7 NI1010 Functional Diagran. 





externai data loopback mode; making 1% possible to detect 
and isolate a fault to the coaxial cable, transceiver unit, 
transceiver cable; or the NI1010 board itself. 

Cn power-up the NI1010 performs a confidence test of 
the cnbcard memories, register and data paths. A LED indi- 


cator shows the rpassyfail operational state cf the board. 
ie Necwork statistics 


The NI1010 ccllects network statistics to permit the 
user te characterize retwork operation. Statistics tallied 


include: 


a) .numcer of frames received 
b) .number cf frames received with CRC error 
c).number cf frames received with alignment error 
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d) enumber of frames transmitted 


e) number of transmit collisions 


FCLr detailed description of NI 7010 Ethernet 
Communicaticn Controller Board, see NII970A Unibus Ethernet 


Communicaticns Contreller User Manual [Ref. 4]. 
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IV. DETAILED DESIGN AND IMPLEMENTATION 


A. CESIGN ISSUES CONSIDERATION 


After studying the NI1010 Unibus Ethernet Communicaticas 
Contreller in detail, some of the common problems with the 
design of protocol mentioned in Chaptsr II can be sclved as 
follcws: 


1.The method needed for a process on one machine to 
S20 


Address and the Source Address field in every trans- 


af 


Destination 


(D 


SieccCity Who Gt “wants to taik.to 1 


mitted frame. 


2.There is no need to find a mechanism for terminating the 
ccnnection across the network, Since the Sthernet will 
put itself to the idle state automatically if there is 


nce carrier on the coax cable. 


3.The rule for data transfer is fixed on the half-duplex 
@e=caticn,i.e@., the data can travel in either dizec*icn, 


but not simultaneously. 


Wercr the errcr c¢ccntrol issue, Ethernet frame format 
provides a 32~kbit Frame Check Sequence field which 
cemtains Cyclic Fedundancy Check (CRC) value. has 
value is generated by the Ethernet board of the sending 
Staticn and will be checked by the board of the 


mecelving staticn. 


5.The problem cf how to keep a fast sender from swamping a 
slow receiver with data is solved by the 16 Kbyte FIFO 
Receive buffer on all Ethernet boards. 


oy 





6.Ethernet board performs data link layer in transmitting 
data encapsulation and recéive data decapsulatiocn. The 
data field of the frame format can vary from 46 zo 1500 
bytes. Thus, ties Gdesagn aseuec “Of the “abzlivty of 
processing at petiers Ly long messages is solved. 
Furthermere, if the data is less than 46 bytes, the 
board wie avutcmatically insert null characters to 


ccmcplete a 46-byte minimum frame size. 


However, che proklem of preserving the order of messages 
meme: SCived by the capability of the Etaernet board. The 
design of ahigher layer protocol would have to take this 
wosue into consideration. The forthcoming sections will 
explain hew to create a design such that it will overccne 
this proklen. 

The NI1010 Unibus Ethernet Communications Contrcller 
Board together with the Transceiver represent the first two 
layers, Physical Layer and Data Link Layer, of the ISO 


Reference Model as shewn in Figure 4.1. 


BF. 8S2030 DEVICE DRIVER 


The NS2030 preduct includes a diagnostic program and 
a VAX/VMS device driver source, hereafter referre 
NIDRIVER, *hat allows a suitably privileged application 
program written in VAX-11 MACRO assembly language or any 
VAX/VFHES high level language (such as VAX-11 FORTRAN) to 


Pypeertace tc INTERLAN'S Unibus tc Ethernet intarface, the 


NZ1010. The application program uses standard VAX/VMS 
services to interface to the Ethernet. There are nec new 
interfaces te learn. NIDRIVER supports all features of the 


Meee v0 centrolier, including full duplex operation (trans- 


Mitting with receives outstanding), non-contiguous buffers 
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Figure 4.1 NI1010 and ISO Reference Model. 


for transmission and reception (often called "scatter/ 
weameer” cr “buffer chaining"), and the extensive cnsroard 
Bpeolligence and diagnostic functions. The standard Qo 
interface allows the network software designer to choose 
among several techniques for perforning I/0: synchrencus 
I/O using the $S$QIOW system service, and asynchronous I/0 
using the fQIO system service with event flags and/or Ast 


maueTnes . 


ug 





Wieneone “SOIC fequecst, an application program :s 
moebe tC instruct the NI1010 +t5 obtain a preformatted 
Ethernet packet out cf system memory and transmit it onto 
#he Ethernet. Similarly, with one $Q1I0 request, the pregran 
can specify the address and length of a buffer in systen 
memory into which the contrcller can place the next received 
packet. Single $QI0O requests can also be used <0 pericrn 
cther NI1010 functiors such as GO ON-LINE, RUN DIAGNOSTICS, 
REPORT STATISTICS, and LOAD GROUP ADDRESS(ES). 

The detailed Cescription of NIDRIVER is contained in 
the Interlan NS2030 VAX/VMS (TM) Device Driver and 
Diagncstics User Manual [{Ref. 5]. 


2. Frogram interfaces + 


ae 


lo 
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Detailed descriptions of ths follcwing standard 
VAX/VMS system services can be found in the VAX/VMS Systen 
Services Reference Manual [Ref. 6] and in the VAX/VHS I/0 
User's Guide [Ref. 7]. Some of the very important systen 


s2rvices are also included in Appendix A. 
a. Using $assign (associate channel) with NIDRIVER 


Before a program can issue requests to NIDRIVER, 
Pree must assign a channel to the WNI1010 controller. The 
Assign 170 Channel (SASSIGN) system service is used to 
assign a charnel to a device. You supply the device name as 
part cf the SASSIGN cali: $ASSIGN returns a channel number. 
The NI1010 centreller d¢vice name supported by WNIDRIVER is 
cf the form NIxy: Because the NI10190 controOiler represencs a 
Eeemoebe “unit (sn the VMS 21/0 sense), the first centrclier 
is called "NIAO:", the second "NIBO:", and so on. 
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rk. Using $ALLOC (allocate device) with NICDRIVER 


A process can allocate a device for it 
sive use using the S$ALLOC system service. Once the devi 
allocated, ro other frecess (except for subprocessé¢s rela 
to the issuing process) can asSign a channel to the device. 

Because the NI1010 controllers provide iow le 
access to the Ethernet. NIDRIVER supports ¢ach controller as 
a non-Ssharable device. When a process assigns a channel to 
an NI1010 centrcecller, VAX/VMS perfcrms an imvdiicit S$aLLOC 


for the process. 


Ge wuSs2 ug $GETCHN and $GETDEV (get device 


Informa ticn) 


Two system services can be used to obtain infer- 
maticn arkcut NIDRIVER: Get Channel Information (SGETCHN) and 
Get Device Informaticn ($GETDEV). S$GETCHN is used to oktain 
informaticn about a specific device. 

When used to obtain information about an NI1010 
contrcller, these system services raturn identical primary 


and seccndary device characteristics. 
d. Using $Q010 and $CIOW (ztequest I/O functicn) 


Because NIDRIVER supports the standard VAX/VMS 
@ne interface, all centroller requests follow the general 
G2oO coOrmat: 


peeress [ €20n },chan,func,{ 1osb],{astadr ]|,f{ astprn ], 
Cet}].Cp2j.Ce3)-(p4),[p5 }-[ 76] 


The first six arguments are dévice/sfunction 
independent and can be used in any controlier I/O request. 
For example, you can specify an AST routine address (the 
Nastadr" argument of the QIO request) if you need to execute 


special ccde at I/O ccmpletion. 
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Device/furction d2pendent arguments ?P1 and P 


tJ 


must be supplied for all centroller operation that use th 


(D 


DMA channel for transferring data to or from VAX memory. P1 
2s the (vir+ual) address of a WORD-ALIGNED buffer. P2 is the 
size of the buffer in bytes and must be even and 1l¢ss than 
1536 (decimal). Parameter P3 through P6 are ignored in 
NI1010 operations. 


(ly) 2/70 cunece tons. To fully understand the 





moO Eunctiors supported by NIDRIVER, one should knew how 
VAX/VMS Ivo functiors are encoded into 16-bit values (the 
function argument of the QIO request). I/vO function values 
have the following fcrmat: 


15 6 5 0 
$m me wm en wm a ne ae ee ee too --------- r 
fUNectLen Med2fiers code 
$ = oe am ane 3 = a = = too oe === - 


Trewmiow-ordes-6 bits Of the Eunection valwe 
are a code that specifies the particular operation to be 
performed. The high-crder 10 bits of the function value are 
functicn modifiers and are normally used +o alter the parti- 
cular cperation specified by the coda. Symbolic names for 
function codes and modifiers are defined by the $IODEP 
Macrc, as described in the VAX/VMS System Services Reference 
Manual [{ Ref. 6]. A modified function can be inveked by 


"OR"ing a function code and function modifier. Fer example: 
ITO¢ SETMODE!IO$ SHUTDOWN 
in MACRC assembly language, or 
IO$_SETIMODE .OR. IO$_SHUTDOWN 


in FORTRAN. 
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The folMowlngedescaibes each 1/0 function 
Supported by NIDHIVER. 


TOS SETMODE! IOS STARTUP 


Issuing a QIO with a Ene. argument ot 
IO$ SETMODE!IO$ STARTUP causes NIDRIVER tc begin contrcller 
cperaticn. NIDRIVER will allocat2 necessary VAX/VMS 


resozurces and pass a GO ON-LINE command to the NI1010 cont- 
boller, The controller and driver will now be in 4 state <o 


process ccmmands and receive packets. 


Cne can modify NIDRIVER's resource allocation strategy at 
run-time. To change strategy, one’s program must sSuppiy (in 
the ICS_SETMODE! TIOS_STARTUP QIO) the address of a guadword 
characteristics buffer in parameter P1 and the size in kvtes 
{always 16) of the characteristics buffer in D2. The first 
femagwerd (32-bit word) Siemene Characteristics buLte= «2s 
incerpreted by NIDRIVER as follows: 


<3:0> the maximum number of receive buffers that 
NEIDREVER (Wall pats to the controller with SUPELY 
RECEIVE BUFFER commands (maximum of 16). NIDRIVER 
will allocate 5S Unibus Adapter map registers for 
Gaeumdsudw result of this “call. If this field is 
zero, NiIDRIVER will use a default value of 4 and 


allocate 20 map registers for receive operations. 


ct 


(Five additional map registers are ALWAYS allo- 


cated for ccmmand DM4a.) 


<31:4> RESERVED (must be zero) 


PiemsecOnd longwcrd cf the characteristics buffer is int 


preted by NICRIVER as follows: 


ib 


God 


<0:;:0> = Q (Default) Allccate a Buffered Data Path 


only when needed t0 process command opératicnas 
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that perform DMA. Deallocate the Buffered Data 


Path immediately after the command is finished. 


<O:C> = 1 Permanently allocate a Buffered Data Path 
+c be used for command operations that pa2aricrn 
DMA. 


<31:1> RESERVED (must ke zero) 


Mesuing I0f SETMODE!IO$ SHUTDOWN causes NIDRIVER to shut 
down network operaticns. NIDRIVER passes a RESET command to 
the ccntrelier. All outstanding receive (IOS_READLBLK) 
requests will finish with a status of SS$S_ABORT. Any allo- 
cated Buffered Data Fath will be deallocated. Any suprflied 
characteristics buffer is ignored for this call. 


IO$ WRITELBLK 


Issuing IO$ WRITELBIK causes the packet defined by Qtro 
parameters F1and P2 to be transmitted onto the Ethernet. Pl 
is the address of a WORD ALIGNED preformatted packet in 
memory. P2 2s the length in bytes of the pretcrmatted 
packet. P2 must be greater than 0 and less than 1536 
(decimal) and even. The packet must follow the fcrmat 
described in Figure 4.2. The QIO request will remain 
cutstanding until tk@ packet is successfully transmitted 
Saeo che Fthernet (cr an error occurs). The I0$_WRITEPBLK 
functicn performs the same operation as the TOS_WRITELBSLK 


eiactiOn . 
IO$_READL ELK 


Issuing IC$_READLBLK causes the buffer defined by QIO paran- 
eters Pl and P2 (address and size in bytes, respectively) to 
bre used to hold the next received packet (or packet fraqment 
Mme DULEer-Cchaining takes place). The buffer pointed to by P1 
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2.2... Se Se re 


| 
se 


transmission 


DATA (0) 


is 8 7 0 
BAR +0 DESTINATION ADDR. (B) DESTINATION ADDR. (A) \ 
+2 DESTINATION ADDR(D) DESTINATION ADDR. (C) ' 
NI 1010 physical | 
+4 DESTINATION ADDR. (F) DESTINATION ADDR. (E) Sadie. as inserted 
@@ into the Source 
+6 TYPE(1) TYPE(O) Addr. Field on, 


+8 DATA (1) 


DATA 


AI cam ty I ed a ce, ERR ee i ie i a 


32-bit CRC 

generated by 
the NI10O10 on 
transmission 


BAR+BCR don't care DATA (last byte) 


nr 


| 
| 
| 
| 
l 








Figure 4.2 Transmit Packet PFormat. 
must ke WCRD ALIGNED. The buffer size passed in P2 must bs 
greater than 0, less than 1536 (decimal), and even. Packet 
Pracenen= into buffers is strictly FIFO; that is, the oldest 
cutstanding buffer will receive the next incoming packet. 
The format of the received packet is shown in Figure 4.3. 
The QIO request will remain outstanding until a packet (or 
packet fragqment) 1s accessed directly into the asscciated 
mie rter. 
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DESTINATION ADDR. (B) 


SOURCE ADDR. (D) 













BAR +0 
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SOURCE ADDR. (A) 
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SOURCE ADDR. (F) 


FRAME LENGTH 
(# bytes) 


@ 
ERC (24231) DATA(last byte) 
CRE (8:15) CRE(16:23) 


Undefined CRE UO.7 ) 
if 1 
BARt+BCR | 


a a ee ee ee eee a ee es ee ee ee eae | 





ee ee ee 
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let. a oS a a ee ce oo 





Figure 4.3 Receive Packet Format. 


Specific Functions 


Control). 


Kc 
jt1 








BPeeause nO €Xistingqg VAX/VMS function ccdes correspend to 
NI1010 specific operations such as LOAD MULTICAST or SET 
PeOmrocuCUS MODE, NIETRIVER supports driver-specific function 
coacs. These codes are constructed by passing whe 
eontreller-specific command in the “function modifier" field 
Cmeene T/C Eunction value. The function value "code" field 
will be ICS _READLBLK, IOS WRITELBLK, of IO$S_SEEK, depending 
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Saewnecther the contrcller-specific command fperfo 
7 


? 


memory access or not. For example, the fo 
value specifies LOAD MULTICAST: 


X20 ! < 052 3 6> = XAAO 


AS a prcegramming convenience, INTERLAN provides symktolic 
names which can be used in the function argument of gto 
service calls. File NIDEF.MAR can be us#d with MACRO 
programs and file NIDEF.FOR can be used with FORTRAN 


programs. 


One can use these definitions in a FORTRAN ovrogram O35y 


including the line: 
INCLUDE USO RAUe ee SoY See RLAN INIDEFsEOR* 
in the FCETERAN source code. 


Cy Ze econo beri on. One should always suprciy 
ie 


the address of a quadword I/O status Block (I0SB) 2ON 
NSosk" argument of tke QIO request. On I/O compl¢tion, the 


ta 
Lxs 


TOSB will ccntain net only VAX/VYMS status, but also cont- 


Moller specific status as well. 


Mex7VMS Status 1s returned in bits <15:0> of the first ICSB 
Memawerd, Bits <31:16> of the first IOSB longvyord de nox 
contain any meaningful imformation. If the returned VAK/VMS 
Sees =5 SSS NORMAL, Nermal Successful Comoleticn, biczs 
meee OL the second IOSB lengword wili contain the Command 
Status Code from the centroller. Refer to the NI1010 Unibus 
Benorne= Communicaticns Controller User Manual [ Ref. 4] for 
pummcemple.e description of the controller status ccdes. 
Appendix F describes which Command Status Codes can be 
expected for each QIO request. Bros, Cote Of4 the secend 


miss 2cngwerd do not contain meaniagrtul information. 
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C. CESIGNING PROCEDURE 


Since NS2030 Device Driver 1S intended <to be 


u 
VAX/YMS fini-computer, the design is based on Didi 
o 




















tal 
Equipment Ccrporation's Network (DECNET) rather than tne ISO 
Reference Model mentioned in Chapter II. However, che 
an See oe ee =a 
| | 
| | 
| | 
| 
y Layeu ISO DECNET 
| jo Gna : 
| Application 
| Presentation 
' 
| 
| Network | 
| Peanmcpont Seny Tees | 
| 
: — | 
eee ene Data link | 
| Come ro | 
| 
| 
| | 
| | 
| | 
Occ cee cane ae a cucu cane ane commen anee enema ame an amp ewes aces aaa eon — Se | 
Figure 4.4 Mapping between ISO Model and DECNET. 
mepemeand cencept is still used in DECNET. The approximate 


Mapping tetwean ISO keference Model and DECNET is shown in 
megure. 4,4, 

DECNET has only five layers. The physical layer, data 
link layer, Eben specramtay cu, and network services layer 
@ererespcnd almost e%actly to the lowest four ISO layers. 


However, the agreement breaks down at layer 5, since LECNET 


a0 





has ne session layer, and the remaining layer, the applica- 
melon layel, is a mixture of the ISO presentation and arpli- 
caticn layers. 

Apparently, emcemiaz030> has Comered sboth necwczk and 
teaneecrt layers, thus, the only layer left to be developed 


is the application layer. 


1. sSseEs in developing ih 


ttn 


application 


hb 


evet 


tet 
li 


With the sugqgésction from the NS2030 VAX/VMS Device 
Driver and Diagnostic User Manual (Ref. 5], VAX-FORTRAN 
programming language is chosen to be used in develorfing the 
applicaticn layer. The other reason to use FORTRAN is 
because cf the provided function argument of QIO service 
call in NIDEF.FOR file in the Driver Routine. This makés it 
easier for the programmer to issue commands to the NI1010 
Unibus Ethernet Communications Controller Board. Steins, 1 


develcping applicaticn layers are as follows: 


1) All availakle system service routines in VAX/VMS 
involving I/O op¢raticn are studied. Some of the very impor- 
tant routines which are used in developing the program are 
mreluded in Appendix A. 

2) The first experiment is to check whether the 
EFrogram can really instruct the NI1010 Board what to do. 
mts 2s done by writing a program that will send out 42 
message to the NI1010 Board and direct the board to send the 
message tack to itself,i.e., send the message from memory to 
the transmit buffer and send that Same message back tc the 
Meeenve Cutter of NI1010 Board. In order to do this, ‘the 
NI1010 Board must be put in the INTERNAL LOOP BACK MODE. The 
detail cf ccmmand descriptions available to be used with 
NI1010 Foard can Ee found in NIi010A Unibus Ethernet 
Communicaticns Ccntreller User Manual [Ref. 4]. The pregran 
that is develored for this experiment is included in 


Appendix B. 


ye, 
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3) The seccnd experiment is to do the same thing 
except that this time the message will be sent out te «he 
transcéiver and ontc the ccax cable, but the Destination 
Address field contains the address of the beard i*se2lé 
(02-07-01-00-07-7F), thus this message will come back tc the 
receive tuffer again. THis is calbed "EXTERNAL LOOP BACK 
repE*. 

4) After the first two experiments are completed 
successfully, the Destination Address field is changed to 
that cf the NS3010 Beard implemented in the MDS system. We 
have two NS3010 Boards, one with address 02-97-01-00-04-0A 
and tke cther with address 02-07-01-00-03-EA. 

5) The next step is to transfer a f113. The same 
type of experiment which has been done in sending and 
recéiving the message i used. The DOWNLOAD and UFLOAD 
procedure inthe VAX/VMS are studied. All the FORTRAN 
statements used in file operation can bs found in VAX-11 
FORTRAN User's Guide {Ref. 8]. 


2. Method te Overcome Frame Sequencing 


It has been mentioned earlier that the NI1010 Eoard 
does not have a capability to preserve the order of 
messages. Therefore the design of the application layer 
Peoeocol shculd take this matter into consideration. 

Pie ser LOnN 1s that ene GCOnVenTioOn GE Communicating 
ketween any *wo computer systems should be made such that 
both stations will be able to know each other's status. The 


convention cf communicating has been established as follows; 


a) .The receiving station will send an acknowledge message 
every time a frame is received successfully. If an 
€rrcr should occur, no acknowledge message wiil be 


sent. 
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b) .The sending station should wait for the acknowledge 
message from the receiving station fora sufficient 
amcut of time (protocol in VAX/VMS is set up fer 5 
seconds), if there is no acknowledge message within 
this period of time it will retransmit the same frame 
again and wait for the ackncewledge message. The same 
frame is transmitted for the total of 3 times ( 1 tran- 
smissicn and 2 retransmissions) before the transgit 


Beccess Will ope aborted. 


c).Tke convention used to differentiate whether the frame 
is carrying a méssage or a file is established by the 
use or the available Type field (2 bytes) of 32ach 


frame. It has been set up as shown in Table I. 


TABLE [I 
Type Field Protocol: (All in Hexadecimal) 


BYTE BYTE2 FUNCTION 

00 Q0 console message 

00 FF acknowledge message 

OF 00 file transfer-first frame 

OF 01 File transfer-intermed frame 
OF OF file transfer-1 record file 


OF FF file transfsr-last frame 


a 


ho eee eet ete ees Sein cenit Inu <oeeguns Sin Ceca SENN 2 arg GAIUS aliens -ceemaans CVRD eemsten canine URRON “SOMMRA eae, emartigas 


7 eae OS a SE A EE EES SSE GG 0) En aa eB ee ee mG en eS ee 
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D. IMPLEMENTATION 


thestand! Software DrOtLoco!l V(application layer prot¢ccc!) 
whose source codé is shown in Appendix C is now available in 
Wey VAS fcr public use. Pits eee Gr anlLsS:-7i) » ie a rade 
ETHERNET.FOR. A user who wants to transfer files cr messages 
ketween VAX/VMS and MDS systems can do so by following ths 
Mase ructions given in VAX/VMS-MDS Ethernet Local 


Communicaticn Network User Manual included in Appendix OD. 
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¥. CONCLUSION 


The principal goals of this thesis were met. The devel- 
oped software protoccl was tested with the actual transfer 
cf messages and files between VAX-11/780 under VMS operating 
system and MDS System under CP/M-80 operating system. A 
file as large as 43 Kbytes was transferred reughly in léss 
than 42 seccnds. 

At present, the program 1s available in VAX/VYMS public 
user acccunt under user name “INTERLAN"™ with password "VMS". 
The VAXy/VMS-MDS Ethernet Local Communication Network User 
Manual is also available in the file "VMSMDS.DAT", The 


content in «his file is exactly the same as the content i 


ee 


Appendix C in this thesis. Users who want to do the message 
Seep tile transfer can get the hard ccpy of this file by 
Simply legging into the VAX/VMS under user name and passwerd 
menticned abeve and frinting the file. Then the steps in the 
Manual must be followed. 


The filés in vubiic user account are: 


This is a program to transfer a message in the INTERNAL 
LOCFEACK mode. 


SEND#SG. FOR 


This is a program to send a message, typed in from the 
terminal, from the VAX/VMS to the MDS Systen. his 
retransmits the same néessage 3 times with the interval 
cf 5 seconds befcre =he transmit process is aborted if 
there is no acknowledge signal from the receiving 
Sea ten. 
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GETASG. FOR 


This program waits for the message intended for the 
VAX/VMS. t sends back the acknowledge signal tc the 
sending station every time it receives a frame success- 


fully. The received message is displayed on the scresn. 


THiS pPrcggzam vs used te cransfer a soscitied file fron 
VAX/VMS to MDS System. It will wait fer an acknowledde 
Signal from the receiving station after every frame has 
been transmitted. The same frame will be transmitted 3 
times with the interval of 5 seconds before the 
transmit precess is aborted, if there is no acknowledge 
Signal from the receiving station. The file is trans- 
ferred by &@ record of 128 bytes so it would match the 


encoractersst2cs cf GCE/7/M records. 


UELCAL. FOR 


UELCAL. 2x 


It is a program used to receive the incoming file from 
the MDS System. It sends an acknowledg@2 signal to the 
sending station for every successfully received frame. 
This pregram puts VAX/VMS into a ready-to-receive-fils 


modé until contrcl-Y key is oressed. 


Pe ERNET CP OR 


This program is a combination of all the fpregrams 
mentioned above. When executed, VAX/VMS will ke ready 
to receive any message in the network which is intended 

A 


for the VAX/VMS. The message will be interprets 
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whetrer it is a@ crdinary message, a request transfér- 


MinNCeOonel Lo OL aprequest Trecsiying of file. 


1).I1f the message is an ordinary message, the 
program prints that message on the screen, 
senes an acknewledg2 signal t~9 the sending 
station, and is ready to récéive ancther 


message. 


2).If the message is a request for transferring a 


file, the program sends back an acknowledge 
h 


3 


Signal and transfers a specified file tot 


en (0 


sending station until the whole file has b 


= 


th W@W 


transferred successfully. The reguest 


ry 


fe 
transferring a file message should includé the 
filename and filetype, FN.FT, of the file which 
the requesting station wants to receive. If the 
public user account does not have the specified 
file, ard error message will be sent to the 


requesting station to notify the user. 


3).If the received nessage is a request for 
receiving a file, the program will s¢nd an 
acknowledge message together with instructions 
to the user of the requesting station to ofena 
new file under the specified FN.FT, receive the 
incoming file until its ali done, then send a 
message to the sending station that the whcele 
file has been received successfully and then 
put VAX/VMS back tc ready-to-receive-messade 


mode. 


All ct these files can be copied by any users by typing 


the fcllcwing commands: 


$C Cry 
¢From: SON RN )E Nie be 
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SUR (OEE NEN.NFET 


where FN.FT is the filename.filetype of the file tc be 
copied fren, and NFN.NFT is the filename.filetype of the 
fila to be copied to. The NFN.NFT will appear in the user's 
directcry after the above sequence of commands aave been 
executed. It is necessary that the file type of the new fils 
should be the same as the old file. 

Future research with VAX/VMS Ethernet Software Pretocol 
should ccncentrate on trying to make the MDS System terminal 
act like a virtual terminal of VAX/VH4S. There are systen 
service reutines available in VAX/VMS which support ‘this 
Capability. Anyone who is interested to do a further 
research in this field can gat ali the information abcut 
these routines from Mr.Aibert Wong, VAX professional staff, 
in Rm. sP505. The modifications can be made without any 
changes in the present programs sSinc= this program is 
desigred with a layering concepts of the network protocol. 

Ancther direction of research is to expand the network 
so that VAX/VMS can also communicate with other systems 
under different operating systems such as ISIS II or 
MCORTEX. 





APPENDIX A 


VA2/ VES SY STEBR SERVICE ROUTINES 


The followings are the VAX/VMS System Service Routines 
which are used in developing the application layer protecol 
for the Ethernet Local Area Network. 


ZASSIGN 


<p 78m 28h cep SOP cD 


SesoiGN = ASSIGN L/O CHANNEL 


The Assign I/O Channel system service (1) provides a process 
with an IvyO channel so that input/output operations can be 
perfcermed cra device, or (2) establishes a logical iinak 


with a remote node on a network. 
High-level Language Fcrmat 

SYSIASSIGN (déevnam,chan,[ acmode ],{ mbxnan }) 
devnan 


Address of character string descripter pointer te the 
device name string. The string may be either a physical 
device name or a logical name. If the device name 
Contains a colecn, «he colon and the characters that 
Helscw lf are. ignored. If the first character in the 
SeSing LS) @ iwnderscore characte: (_), the name is 
considered a physical device name. Otherwise, the name 
2S considered a logical name and logical name transla- 
ticn is performed until either a physical dévice name 
is fcund or the system default number of translaticns 


has been performed. 


If the device rame contains a double colon (::), the 


system assigns a channel tc the first available netwerk 
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device (NET :) and performs an access functicn on thea 


network. 
chan 
Address of a werd tc receive the assigned channel 
number. 
acnode 
Access mode to te associated with the channel. The acst 
tivileged access mede used is the access mode of the 
Galle: M7O™m Ceera-1 enc. on the channel can only oe 
performed from equal and more privileged access mcdes. 
mbxnag 
Modress OL a Character string descriptor pointing to 
the logical name string for the mailbox to be agsoci- 
ated with the device, if any. The mailbox receives 
status informaticn from the device driver. 
an address of 0 implies no mailbox; this is the default 
value. 
Notes 
1) Fer details on how to use SASSIGN in conjunction with 
network cperations, See the DECn2t-VAX JUserts Guide 
{Ref. 9}. 


Zz) Only the owrer of a device can associate 4 mailrox 
With the device (the cwner is the process that has alliccated 
the devices, either isrplicitly or explicitly), and oniy one 
Mailkox can be associated wit a device ata time. Ifa 
mailrcx is associated with a device, the device driver can 
send messages containing status information to the mailbcx, 


aS in the following cases: 
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a).1f the device is a terminal, a message indicates 
didal—-to, fangd=-Ue, “or the recepeion of unsclicited 


pie |clbl cape 


c).If the target is on a network, che méssage may 
indicate that the network is connected cr initi- 


ated, cr whether the line is down. 


For details on the message format and the information 


returned, see the VAX/VMS LTyvO User's Guide (Ref. 7}. 


3) Channels remain assigned until they are explicitly 
deassigned with the Deassigqn I/O Channel (SDASSGN) system 
service, or, if they are useér-mode channels, until the image 


eaac assioned the channel exits. 


4) The $ASSIGN service establishes a path to device, but 
does not check whether the caller can actually perform 
inputycutput operaticns to the device. Privilege and vorot 
tion restrictions may be applied by the devic2 drivers. For 
detaiis cn hew the system controls access +o devices, see 
the VAX/VMS I/O User's Guild (Ref. 7]. 
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scien 
$QIOW - CUEUF I/O RECUEST AND WAIT FOR EVENT FLAG 


The Queue IvyO Request:and Wait for Event Flag system service 
combines the $QIO and $WAITFR (Wait for Single Event Flag) 
systém services. It can be used when program must wait for 


I/O ccmpletion. 
High-level Language Fcrmat 


Sranelewmciezn }],chan,func,{ iosbj],{ astadr }j,{astora }j, 
Cel} Ce2}-(Cp3),(p4 JC P5Je(06)) 


efn 
Number of the event flag that 15s +o be set at request 
eomcecletion. if pet specified, it defaults to 0: 

chan 
Number of the IvyO channel assigned to the device to 
which the request is directed. 

func 
Functicn code and modifier bits that specify the overa- 
ticn tc be perfcermed. The code is expressed symboli- 
cally. 

10sb 
Address of quadwerd I/C status block that is tec receive 
final COMpPLetion status. 

astadr 


Address of the entry mask of an AST service routine to 
ke executed when the IvO completes. If specified, the 
AST routine executes at the access mode from which the 


$QIO service was requested. 
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astprm 


AST parameter to be passed to the AST completion 


EeUTone. 
PimcO po 


Cptional device- and function-specific I/0 request 
parameters. 

Thea first parameter may be specified as plor plv, 
depending cn whether the function code tequires an 
address or a value, respectively. If the keyword is not 
used, pl is the default; erat is, =“he arqument <1s 
considered an address. 

F2 thrcugh Pn are always interpreted as values. 


Notes 


1) Tke specified event flag is set if the service *term- 


nates without queuing an I/O request. 
PyeThe 1/0 status block has the Ecllowing format: 


eit 16e a> Q 


BYTE COUNT STATUS 


DEVICE- AND FUNCTION-DEPENDENT INFORMATION 





Byeecea us += COMeletion Status Of Bhe 1/0 roques< 


d. 


the 


Mm 


Peeves counc - Number ot byte actually 2ranstere 
Neote that fcr some devices this contains only 


lew=-Ceae:t wore of the count. 


c).device- and function-dependent information - Varies 


according to device and operation being performed. 
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The informaticn returned for each device and func- 
tion code is documented in the VAX/YMS I/70 User's 
Guide [Ref. 7]. 


3) Many services return character string data and write 
the length of the data returned in a word provided by the 
caller. Functicn ccdes for the 5QI0OW system service (and 
the LENGTH argument cf the SOUTPUT systam service) regqnire 
ie-meen Specifications in longwords (32-bit word). i 
lengths returned by cther services ar2 to be used as input 
parameters for SQIOW reguests, a longword shouid be reserved 


to ensure that ne errer occurs when $QIOW reads the length. 


4) For informaticn on performing input and output opera- 
ereonS ch a network, see the DECne+-VAX User's Guides 
(Ref. 9]. 
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SEINTIME 


SBINTIME CONVERT eA SCEE STRING 


Mme Ccnvért ASSCII String to 
Semverts an ASCII string to an 
in the system 64-bit 
Set ($S ETIMR) 


services. 


Timer or 


High-level Language Fcrmat 
SYSSEENTIM 
camp u f 


Address of a character 
the kuffer 


converted. The 


are described in the Notes, 


Address of a guadword that 


time ir 64-bit fermat. 


Notes 


1) The $BINTIM 


+he caller and dces net 


= & 
ae 


accessible before executes. 


tion causes 


time format suitable for 


Schedule Wakeup 


(eam Cut 21 Madr) 


string descriptor 
containing the absolute 
required formats of the 


service executes at 


an exception condit 


DOV BINARY Sees 


Binary Time system service 
absolute or delta time value 
input to the 


(SSCHDWK) system 


peantang-. =o 
or delta time to be 
ASCIT strings 


below. 


is to receiv> the converted 


the access mcecde of 


check whether address arguments are 


Therefore, an access vicla- 


Nom tn, the inNpuls | OULt er Or 


mises GESCriptor cannet be read or ths output buffer cannot 


ke written. 


é) 


menc list, and therefore 


(insufficient arguments) 


does nct receive enough arguments (for examples, 


a3 


This service does not chack 
cannot 


GErTOL Status code. Tt 


the length of th2 argu- 
return the SSS$_INSFARG 
the service 
omits 


1f one 





required ccmmas 


result. 
3) The required 
Absolux<e: Times: 


Delza Time: 


ieee Nere a) ie); 


dd-amm-yyyy hh:mm:ss.cc 


gedaan nme ssc Ce 


one might not get 


RSGE fea not estoings have the format: 


Field Length (bytes) Contents Range of values 
dd 2 day cf month tee a 
- 1 hy phen Requizted syntax 
mm m 3 month JAN 353,59 An, Ace, 
MAY, JUN, JUL, AUG, 
SEPE MOC ~ NOW a DEC 
- 1 hy phen Beaereos Seas 
yyyy 4 ear lee = 999 
ank n Lank Required syntax 
hh 2 hour VOT = i823 
: 1 coion Required syntax 
mm Z Minute 00> =) 59 
: 1 colon Required syntax 
ss 2 second OO 2557. 
® 1 period Required syntax 
ce 2 naMcmeed=hs of . 00" = 99 
second 
dddd uy weomnocruOredays 000% 9999 
(in 24-hour units) 
Note that month akkreviations must be upper case. yy 


the hundredths 


For example, 


Of VAX VUS, 


of second field now represents a true fraction. 


contrast with previous versions 


the string .1 represents ten hundredths of a sscond (cne 
the string .01 represents one hundredth 
be added *o 

this thousandths of seccnd 
hundredths 


beyond the thousandths of sacond digits are ignored. 


fcomen OL a second) > 


of a second. Note also that a third digit can 


the hundredths of second field; 
reund the ©= Seconda “Value. 


meager ifs used to 


Digits 
4) The 
ASCII input 


feivecwanague syntax EUles apply to Specifying the 


Svea nd: 
a).Any of the date and time fields can be omitted. 


Fer absolute time values, the $BINTIM service 


Supplies the current system date and tine fcr nonsfe- 


Giyeeecdatlelds. Trailing fields can be truncated. If 
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leading fields are omitted, the punctuation (hyphens, 
blanks, colons, periods) must be specified. For 
example, the following string results in an absoluts 


time ef 12:00 cn the current day. 
Ves Os 00S OW 


For delta time values, +he SBINTIM service defaults 
nensrpecified hcurs, minutes, and seconds fiesids to 0. 
Trailing fields can te truncated. If leading fields 
are omitwed from the time value, the punctuation 
(clanks, colons, periods) aust be specified. If the 
number of days in the delta time is 0, a O must be 
scecified. Fcr example, the following string results 


in a delta time cf 10 seconds. 
Os 210 


Nete the space between the 0 in the day field and the 


ewG CCLOns:. 


b).Foer both absclute and delta time values, there can 
bre any number of leading blanks, and any number of 
blanks between fields normally delimited by blanks. 
However, tkere can be no embedded blanks within 
é€ither the date or time fields. 


The fcllcwing examples illustrate legal input strings tc the 
SBINTIM system service, and che tine represented by the 
cutput from the $BINTIM system service (translated through 
Smemecnvert Binary Time tO ASCII String (SASCTM) systen 
service). assume that the current date is 4-JUN-1983 
Otel 329.00. 


Input tc SBINTIM SASCTIN output string 
-- :50 14-JUN-1983 04:50:28.90 
--1984 90:0:0.0 14-JUN-198u4U Q0:00:00.00 
9-NOVH1982 12:32:1.1161 9-NOV-1982 12:32:01.12 


fis 





th 

© 

—" e 
WS) 43 
@6 
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Zea NER oO et Oses 2s 001.00 
Ors0 007005 90 = 10 
OF 00:00:00 506 
MOS Ie see 
Zee 00s 00. 00 
O 05:00;:00.00 





SS Se 2 oa = SS 


The Set Timer system service allows a precess to schedule 
the setting of an event flag and/or the queuing of an AST at 
some future time. The time of the event can be specified as 


aapsclute time or aS a delta time. 


When «he service is invoked, the evant flag is cleared 
OC 


feviemnt tlag 0, if nere is specified). 
High-level Language Fermat 


SY cSSETIMR (Petn le,daycin' ,(dastaedr] ,{ reqidt }) 


efn 
Event flag number of the evant flag to set when the 
time interval expires. If not specified, it defaults to 
oe 

daytino 
Address of the gquadword expiracion time. A positive 
time value indicates an absolute? time at which the 
timer is to expire. A negative time value indicatés an 
orfset (delta time) from the currant time. 

ast2adr 
Address of the entry mask of a AST service rceutine to 
be  Celled when the crime interval expires. Lf not speci- 
Mads lt wncecaules 2<O.O, IndzcCating no w“AST 2s ~-tobe 
queued. 

eoq2dat 
NumEer Gndacacing a «request “identification. I= 20% 
specified, it defaults <to Oe A unique request 


ar 





M@entaticadtion can be specified in each set <*iner 
requests, or the same identification can be given to 
related timer reauests. The identification carn be used 
later to cancel the timer request(s). If an AST servic 
BouUcine Ls specified, the identification is passed as 
the AST parameter. 


Notes 


1) The access mede of the calle= is th? access mnede of 


the request and cf tke AST. 


2) If a specified absolute time value has already 
passed, the timer expires at the next clock cycle (that is, 


within 10 milliseconds). 


3) The Convert ASCII String to Binary Time (SEINTIM) 
system service converts a specified ASCII string to the 
guadwerd time format required as input to the SSETIMR 


=-- Vi Ce. 
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SWAITER 
SWAITFR - WAIT FOR SINGLE EVENT FLAG 
The Wait for Single Event Flag system service tests a 
specific event flag and returns immediately if the flag is 


set. Otherwise, the process is placed in a wait state until 


the event flag is set. 
High-level Language Fcrmat 


SYSEWAITFR (efn) 


Number of the event flag for which to wait. 
Notes 


The wait state caused by this service can be interrupted 
by an asynchronous system trap (AST) if (1) ‘the access mode 
at which the AST executes is more privileged than cr equai 
in privilege to the access mode from which the wait was 
issued and (2) the ecrocess is enabled for ASTs at that 


access mode. 


When the AST service routine completes execution, the system 
repeats the $WAITFR request. If the event flag has been set, 


the precess resumes execution. 


ihe 





SCANTIM 


BeANTIMN = CANCEL TIORER 


The Cancel Timer Request system service cancels all ora 
selected subset cf the Set Timer requests previously issued 
by the current image executing in a process. Cancellaticn is 
based cn the request identification specified in the Set 
Timer (SSETIMR) system service. ie Ore =han “ore “es 


mer 
request was given to the same request identification, they 


aze all canceled. 

High-level Language Ferma* 
SYSSCANTIM ({ regidt] ,{acmode)]) 

reqidt 


Reguest identification of the timer request (s) +o be 
canceled. A value of 0 (the default) indicates that all 


timer tequests are to be canceled. 
acnode 


Access mode of the request(s) to be canceled. The mest 
privileged access mode used is the access node of «he 
caller. Only those timer requests issued fro an 
access mode equal to or less privileged than the resul- 


tant access mode are canceled. 
Notes 


Cutstanding timer requests are automatically canceled at 


image exit. 
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SOURCE CODE FOR EXPERIMENTS 


All the source ccde in this appendix was developed from 
the step-by-step design of the Ethernet Software Proteccl. 
Each cf the programs includes a brief explanation of the 


function when it its executed. 
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PROGRAM ETHERI 
PeavoronaMigonGe/’ INi seal LOOPRACK , 


character*ed5 fextey toads message will oe sent. '/ 

intaqer*e 19¢9$0(2) 

inteaer*d Nichan, svstatow, Systassian 

include “eae aos [inmoscsyvys. inter!) an|laidetf.foe' 

include "C8iodef)' 

byte Toecketti56), Foacket (146) 
Agssian destination address: 

packet (1)=2'O0e 'x 

Poacket Ce )=" 07 x 

Noacwet (3)s°01" x 

foageret (4) Ss" 00% 

iene sett Ss) =. x 

Hee (oto) = <r x 
Tyoe aSsianment: O000Snsa, etc. 

lorie corey 7 =.) ' ox 

TosaekrtleoJ= 00. x 
ut woaca 1oto transnit oacket: 

}= 

ole 121,26 

Meg eee pote Cert ( }23)!) 
j=) 


end do 
AG 13555156 
Tosgemet())="00 x 


end do 

Psstqgmuarvcmanne! to NPs0: 
istat=sysfasstian('NIAO',nichan, 
1fCsnot-istat) call 1ibistoo(%vallistat)) 
tyoe *,' A jistat=',istat 


StartruS and 959 on | ime: 


Votroat = SYS HIT DWN ss Gvo lt nier an), 
Mert tose Set NO Je. .Or.e TObmesSt art up), 

2 1) Sey) 9. 8 

iiGemeteals Gat)  GalleslVon Stoo (4yal Gistat )3 

VP C1rocb( lJumelt)> cal!) \rbesstool(4val(i0os5(1))) 

[VCE wer OMT Seat = »1Stat, Ss 3050 l=", rospn tl) 
Internal looopnack: 

1stat=syssaiowl,tval(aichan), 

! A4vallCioeesilon), 

C 1OSO piv Por) 

Pt —notsistet) Calluliocstoottyaltlistat )) 

ft Ovoce( 1) enews!) @eal!) mip tsto0( 4a Cio])eo (1 ))) 

Svercwmeoe Jl “160at= >gistats  _1 165901) = yiocse l)) 


eromrtscuous : 


"St2t=Svstboiowls4.val Coichan), 

1 ~A~al( 106esSDeFrT), 

? Te@eSion pia ana ) 

Wiener stset) es) | Vibe ot oot. va l(1st at )) 
PrGavoce Cl) .nhewin call lyesstoot“y al (yo055 (C1) )) 


Giz 





Receiv® on error: 


Tra 


Loac 


Rec 


Totot=ovsuciowt, oval (michan), 
“VallCioeesroen), 
WOSO;, pore 

tJ call liiStstoo Gaya) 

ani) cali=Tyotstootty 


ado oa 


-_~ ron 
pe oh 
~~ 

pee ol 
‘Ds 
—_é = 


nsmit SoG cet 
istat=sys}sai chan), 


(nq 
(inotewritelolk 


met an. 
f ( foo tZy. 
f ( stools 
yoe *«,' | ista fe) 
yoe *, Toacket 


transmit data and 
istatesysbaiow(,iva 


Fb 


a is Jj a4 
amt, 
oh ae 


qu 


O ~--D 
wow wer 


~ns 
Yn A 


= As =< tp 
ow ce D 


Ce mt CAT po {) CRN ate te LAr 
o 

Seek @ i) 

> ie Bre) 

Q An 

IO 


<< —é 


Rot. stat) ca 
t,' Messaqe } 


On 
Me 


e me oacket: 

t Pom tneacety ina 

} SPpaVvon ly, vel (a1onan )> 

1 4vallCios$tereadliolk), 
Pag 2OSDer¢ 

3 ZereflRoacket),2Z PSO) pup poe) 
t =", 1050 ( 

} Vibsstoo(%val Cistat)) 
] Lele ns too 441115 sh 6 
t Tstat, = Se lye tage 
1g 5 
1 

3 


wipe (Uke ackcet (1) .mne.tehart*.')) 
tyoe *,charlRoacket(i)) 
Te 
Sng a5 
eal exit 


end 
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PROGRAM SENOMSG 


ACTUAL SENDING OF VESSAGE,. 

MATT FOR ACKNOWLEOGE. 

TF NOT SBCKNOWLEOGE IM 5S SEC, RETRANS“MIT. 

TF NOT AGCKNOWLEDGE [INO 19 SEC, A2RORT TRANSMISSION. 
external 200rt ; 
integerte feoco Ge) ,acdr 
inteqer*4 Pens, asvG: aioN, SYS 50SS1> 
integerr«d sysbbintine sysdsetiner, sys ett 
Int 2aqaerrd systinel?),tine(2) 
include Wedgravevaessys.interlaninidet.tor' 
include Ch ioget )* 
ovte Bat 1 )0) 
byte ose cor) $o),?rext (129),-54ac cer (159) 

Assiar a channe! to NIAO: 
ovat =Syvebacsc vont: Io 0 Goatelan,s 
ian oteborote co!) libastoot 4731 1st 3e)) 


Sieact uo ame cao som ) ine: 
WS tat =<S6$7S Soiowls vio! (atonan), 
1 Eva Gro-esetnodce 2or. 19% tartuo), 
Pl OS Dor > 5 pr) 
Piece ootwmia cst veal? | Tone too ( Zval (\st at) 
ioloce Gleemenia) call byoaestool4valC1oso001))2 
Assian destination address: 
Naecrat ct) =) 0c" % 
Tfoac<e tte) = 07's 
besackaet (5)270 1" « 
Tf saeice te (el e800 * & 
Interact with user: 
GiCcem xe moe lecta Netmamoaress Of Destination: ’ 
tyoe *«, * MOS Systen ON9N-04-04 =: tyne"*{"' 
tyoe *, ' “MDS System O0=05-=EA +: type"2"! 
read oy |i Jacdc 
fornat Cal) 
ft Cagotoeoe 1) et je5 
Toacker(S)='O04'x 
Toacket (6)s'OA'x 
else 3 f Gadaeeeao. «¢ J then 
Peaqcmet (5) = 0S x 
PhoaGeo elo) = oe x 
else 
agoto 29 
end if 
vee, nomtemesscoce liegt char 33x )ent wien * * 
reat(S,2e)text 
rortat (12 34a.) 
Sssi9gn tyce field? 
feackor C7] 00 ' x Lia ve ate or har Vt 2¢ 4 messace 
Waacket (5 )s a7 x moon ft. Care 


ace 2 YatOuUtransm)t oacket: 


| ie ana 
0 Vela cs 
Wosae wot Cl jaetext (4 } 
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oh 


jrjtt 
end do 


imoamsmit Ooacket: 


istat=sysbaiow(-,-ival(nichan), 

l faa leno senwri1relal<), 

rad VOSODs s.r 

Sop “aref{Toacket),“val(155),.¢,) 

milGtemowne) a) t. 0) Sercmmlao ns tool cya) fiosat |) ) 

ieee) .9ae. 0) calmer stom © 4val(15os0( 2) )) 

Bvyoe x,  “eSsaqe  wSe pera transmitted... s.s' 
LoaGetrans Tit. “Nata and “send: 

yetat=sVsSeo010Ww(, 2ValCa1e€han), 

] Z~Zvallioeeltas), 

Pa VwOSO7 + vo b6.9 9) 

i Acree tio Gale ~ li eostool4valli@se Cl) )) 

if Soe et Neel colds | voestoo! “volt jiosn( 2) 0) 


( 
( 
vay ctor lUmseconds and obo nt: 
lees yismeeia trim 0 ost 0 yt) ne) 
Pt SYS ooetinur(, Clnes,avort, } 
Nait for 5 second and retransmit: . . 
Car | sys bunt ial) Uso. 0 esyvstyre) § catransmn t 


call svstsetinr(1i,systiners, ) ster ore Soc 
Receive acknowledae: 
is Stat=svstaiow(, val (nichan), 
1 %AvallCiotbereadini«), 
O 1OSOrer, 
cs Apert (roacwet ), Aval(159) 477-4} 
VeGuesco (lets 0 eal lkvoustoum~syal(iog5¢ 1) )) 
it Oo eterno. cal lo lve tstoo. 1a) 015685 Ce )) 
Gnecc the “secon ) Cyoe tield 14 = FF hex? 
efi ESIC NT US Se aa then 
} = 
do pen ee aoe Ct) ne.ichar('~')) 
= yee 
end ao 
MEWS. oOs, 0 OaC ket Pf )s ) =1074 = 1) 
fommatt |. <1 >a) 
call systcantin( , ) , cancel ftiyner 
Roacker (1A8)='O0* x 
Source | 
end if 
eall svstwoait te (]) 
aoto 30 
end 


Z=—Z=—2OeOeO CeO GC OGRE COCPre CCEECCECCUCCCECCCCECCECCECCCCEC CECE eC CEC eC CceG 


Zee 


SUB RODE ARURT 


write l6,y7 cee ) 

torpnmatl ““2Hort Transmi¢s19n' ) 
Cale! 6 wat 

end 
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: PROGRAM GETYSG 
c ACTUAL RECEIVING OF YESSAGE. 
& SEND BACK AC<XNODWLEDGE “SG.(2nd tvoe fieldt=FF ne 
C IF RECEIVED 34D FRAME, 99D NOTHING 3UT WAIT TO «* 
enaractee*- 5 nsal/' Receive succassfullv. 
int e@aerk 160So0 le) 
integerr*d Miewaa, SV¥Staiow, svs5 eae eae 
Include "ecraQ: (nossys.interlaniniaz 
include "(Ei odef)' 
ovte operon) Jno) 
ovte ROace ewes), loac<et (155) 
byte Af) laant st} ,s4711nam( 3) ) 
c Seciaa)4 cchanne! 5 ee 
VobEot=Syocuasslant Via smicnan, +) 
ish OMe iatwats) et yor urs © 15.54 shy ornrer!’ 
o Start. wo. sna yao on elryne: 
IStat= sysbhoiowl, 2val Cnicran), 
Mums tore Seto ge .Or.. 1ofnest 4Fr tf uo} 
C WOSOe spre rp yt 
1 etemMot eistot) + voe *> SIStata strrt wo erro> 
Pet oso Gl Jit . U) weeoee <.. Mom aet uo Yen ror!” 
C Receive inconino nessaae: 
10 VOG Tk, MNO y mt OlMinoG > 1V G54 ssc se 
Stat =SVSeG1On (reat) (Sisnan), 


e 

IC 

} 

I ~Zyvalliofereadinrl«), 

2 19SD¢6e,% 

3 Seewteupaewet ) > .yal (1S) )4s 77) 
Glenmore) stat) then 


? 


ool (aus re Se de 


oc x 


tyne *, send nsg istat receive error 
AO MOm 0 

end if 

Hae Sorte) te) ot hein 
tyoe *<,'° Send isa YA 7VMS Receive error 
goto. bo 

end f 

iim oso lc) .eq.).) tse 
Ey oem, Oe miGianSG receliyv> Biock C2e 
Agro 10 

end nit 

It O1oso Gc) .ea<e) then 
tyne *,' Peceivea block saliannent error’ 
aoa 40 

end if 

IfGiosr(2).ea.4) then 
ryoe *,  Sen9 7S9 mIS6195 Feceiva 3) 
SO poe 

end) wt 

1fliosodlc).eq.17) tnen 
tvoe +,' Sens nsaqa DMA raceived a19¢< 
goo 1) 

ena if 

f=1% 

do Sune a SCG be eNOS et hy 


} = | 


d do 
RESTON ee OH ence eae 
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11 Comm ae: ae gs hoa 1) 
EVoew arene ce; ved suceass fully.’ 


E Assign destination address: 
foacket (ij=" 02" 
Foaeret(2)= "07" x 
lose Metts = Ute 
Woacweontd)oxoacket (14) 
Toacket (SJeRnacket (15) 
Poaeret (5) =" packot (165) 
C Assign tyoe fields: 
loaackmeor (¢/)=° 00° x Uyvadvecate that .1t 1S a ressace 
Noaeket ()="FF* x ! ascknowledae sianal 
iG fUcwoata Into tCransnit pac<st : 
Gorey = ec. 
eT ie al Westar CNS mt Ws ti) 
ey 1 
end do 
[s Transmit oacket: 
1statizrsvstaiow(,%val(richan), 
1 Deal CVobewr telat); 
? LOSO 7 7 4 
5 iret (hoac we! ligt al 0) SO0w > ro) 
TPOsienelewiett 0) "oat unsstoo.4yviat (rosa t lL) )?) 
veces “clemowloedge 1S Reina. tranmsnt ©ted...... 
e toad transmit data and send: 
1Stat=systaiow(,-4Zval(nichan), 
1 Zvalfyoeeltds), 
2 OS Oi) 7) pipe) 
MmevocoG@l walter) tyvoe *«, —Fther xi error 
VWiltoseley.me.0)  tyoe *,'° Controller xmit error!" 
Goto 10 
end 
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MMOAMAM”AN 


SOMO? 


MreM 
Oo 


PROGRA GPR AD 
AC Tua Re Qe leeks 
PT SCARY Shas MR 
CHECK FOR 1 RECQED SLI 
SEND BACK ACKNOWLEDGE “SG. (ZAAGeee Oe (1S) de nex) 
IF RECEIVE BAD FRAME, DO NOTH woes ap) WO Sele Tye 
SAME FRAVE AGAIN, 
character*24 moal7: meceivedq successfully. * "7 
integerrke 1oSm(c)sdone 
inteaqerr4d Miremoanwe SYS -d1Ow, SYS 5456 190m 
include FEGravewaOSSYVS.einter lanthaicef.for' 
include (tae 46% )” 
byte o0ad(100) 
byte Poacketc1 70), 1f11laan(10) 
byte boae <et 1560) 
Mecueme ae channe | “foe lo. ¢ 
istat=svsiassian('NIAD'’,nichan,,) 
it Canot sete ac allel th 5st ool 2yva) (4 stat ) ) 


Niort te JO aAndsae on fine: 
Motat=s Syocavow ty -val (Ai chan), 
Avall(iosesettnode .or. iosmestartun), 
red TOsSOr s,s boro) 
j a) 
1 oo oh ae ap i ae 
? tart uo error' 


tat) call liobston(%v- 
lv S toc (- 
ro 


ann 
yOoemR> Contr 


la(eies 
Ae aes, 
ler § 


| 


tateract wit 
tyoe *, 


a} 

) fone *1lenmams? 
read(5,92) 

nN 

i 


On) 73 
—~-Q) es 
— + 
jJ-— 
ret) 
| 


Gt jaa! 
format (as 


OQ —nx7 TT lt ~tD 


Hen ane —-,OCaaml 2st | 
St. 


"seauential'’, 
arriagecontrol='li t3 


ae t=ios,err=7) 
: Noen Wns tari. ley saain’ 
(oe Soiteon 4041 - Cros) ) 


Receive file? 
CVoeC rtp Bpeagy ets re 
Istat=z=svs8ainw(,4val 
“val 


2ceaiVve error?! 


1 
Z 
3 Zref 
i 
1 
1 
1 Rocko file 


7 f 
ie Ce saiewe tls). eg. Fre’ x) “then 
done=1 
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gqoto.70 
end if 
write(2,550) (Roacket(j),j219,1%6) 
550 fornat (12341) 
ie NGsiscnm destinatyon address? 
7) Teacket.Cl)=" 0c ’x 
UsacideriGe :=')/* x 
fosaeicet (5) —=' 01 *x 
aac aed) spac <et (14) 
Toacket (5) =Roacket (15) 
Toacket(6)=Roacket(1o) 
C ASGiant yoe 11e1] 4: 
eaecet (i J=))C x J amagicate that it 15.4 °nmecsecqe 
Goacwat Ge = Fos 4 (saeknowlvedaqe sians! 
C Put data into transnit racket: 


-9 
AG t=, cd : 
Toa iar eG ears ey 


i) 


end a5 
& Transmit oacket: 
istatssystaiow(,Zval(nichan), 
1 ~Zvalliotewritelolk), 
2 19OSDesrs 
5 pret Clesge<cet); 4Vallisolyso4 3 
ie enocmlle) tate OUmea lb ohip > stoo (aval Cyoso( !))) 
[vaem. ack mowleodae 1 Deing transmitted ...<.n 


C Load transmit data and send: 
totat=6 7S co row l, .val (aieoan) + 


\ “4vVallioeel tas), 
2 TOSS rr stern) 
Milos ul ste tyoeet, Cther xmnit errorl’ 
Mewosh ec lsmewu) tyooe *~, Control ber xmit error! 
WieeGaones=“a.i) goto 50 
aiet oreo 

30 Close (Umit =c ) 


tyee *, * Receive comoletedq!t’ 
call exit 
end 





MOOM 
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PROGRAM DOWNLOAD 
SCTucm Peat GPee wr lees TATERAChHI JE. 
RETRPANSMIT SAME FRAAE [F ND ACKNOWLEDGE IN 5S SEC 
ABORT TRANSYISSION [FF NOT RECEIVE ACKNOWLEOSE | 
external abort 
inteaer*? Veco.) 20ers oUnt yl tone 
inteaqerrY NVen ams SVSSO rows. SYS 0aSS19n 
integqer*4s furore), Svs anes sec | - } 
include Pedra: [nossvs.interl ani1ide 
include GE To cet 
byte aaa! 00D 
byte Toac ket (136),sfilnam(30 
hyt2 Roae <2? (150 } 
Sesion ‘awe manne 10 > wien ¢ 


Toc at=oysjoas 


eqiant Via, ate 7 8n, 


Vioesmot. 15 3 ¢) 


onc ae 


Stort 


UD and 


Leo rS toot ZV 


7 =i Wi oD I) 
rae SO) 

~ ~~ 2 } 

wes (Qe OR 


Ne wee (f} ee 
-— e« « «wrt 
Rperrgoo-—. 
es ¢© =" 
ean Fa) 


Tee 
DOoo-~: 
Se 


=~ = «# =) 


x KK KK 


Interact 
tyoe 
tyoe 


DK & 


-~_ = & «@ ib 
Mow ODI 
-= eft -— @ 
Dd 
=) 


whrod as 


«wm 


x fp fies, 6 ae 
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Das t Was 6 yo. 
FYQDe 
tyooltpt 


eo 
SCA Sa ast 


e 
ud 


§ 
ier 


Peacimt- )= 0) 


) 


5 on 


nex 





2 


WO 
CO 


iw 
OW 


O 


101 


Hoemat Ca700 5,1 } 


o0en(name=zsfilnan punitsl,orgqanizatio n='sequentia 
| FEeyoe= " OlN s,ecarriagecontrol="lyst ,orrs ©} 
Got ows 
tyoe x, No such file! ity again 
aqoto 20 
Transmit oacket: 
count =9 
readin ost at =1es,e00-100,err= 101) 
1 (Toscket(j),j=9,156) 
format( 128a1) 
Votat=Svcbhaiowt, 47491 (m1 Ghan), 
t LVartvorexrivtelsle), 
a 1OSOrer.s 
3 mrefCToacket),tval (lao ery») 
Vile elke v meal) IvonstooCZval (vasa }))) 
1flvoch le) one.) tyoe Gomme rol le: La ewe ares 
tvoemwrtse Gaeke 15 Oe oa) Pranem1t tes<c4 ca 
Load transmit tata and send file: 
lotor=Sys Salvo, val (michan), 
t %~vall(ioeeltds), 
4 YOSOr peep ew) 
WetosOsin (lsc iehes 0 ) Ue Voor 8&4. OY St ea xin) tec ror. 
Vt Cioemucy anes 0) “ty5e-*," Controller 2nit error: 
tian t fOr 20 SACOnNCS (and sboort: 
Call svstointrinC' 00> 32290.0" ;sec) 
Gall Sy¥emicetinrl,secs abort; 
Nait for 10 seconds and abort: 
Call svesountein. 0 33 10.0°, tins) 
call sysbBsetinr(le-tine,s, ) 
Wat) for Scecona omd retmamnsrit: 
Carles ys sey nt me 0 © 250 > systine), {watt “for 
CallesvshGetimrel,ocvst ine, ») Peace now ledce > 
Receive acknowledae: 
1Sstat=sysHbaiowl(,4val (nichan 
l 4vallioteres ANN 
2 TOS C+ + % 
3 Zref(roac Cig VC Vapas oo) 
@ieck ‘the second tyoe field 1f = FE nex: 
i f (Renee Sei coer then 
Cal asvysac ant vr (s.) Y ‘cance | tiners. 
Roacket(19)='090'x “even <Flaq 
tt icdonewea. |) -agtor 30 
loackeoet 2) =° 01x aoe |e tr amne 
aoto 30 
end if 
if Ce¢ount.ne.2) then 
Ca) leseyvscbeoit frti) 
CoOuUnt =CoOuUct tT! 
qoto 44 
os ah pee a 2 
Cail sysSowaitfirle) 
(7a ty) Seva 
Gali laomct oot. 4a) C10Ss )) 
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C Assian value to end  msssaqge: 
100 ao. 1=9, 150 
Proscket (4 JZ" <x  Slank <hoaor 
and d 


9 
iaacwetics ) =? Feit ! lastfrane 
done = 
goto 40 
50 type *,' Transmit tomoleted' 
eclose(unit=t) 
qgeto, 10 
end 
MMMM CEC COMCECOCCOCECE Cimmwee CEECECCECCCECCCCCECSECECCCECECECCCCCCCCE 
SUBROUTINE ARQPT 


erate o,ec4-) 


eee fornat(! Anort Trammissioan’ ) 
Cenelume x| t 
oq 
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2 ee 2D Se Se ee ce 


ETHERNET SOFTWARE PROTOCOL SOURCE CODE 


This is the actval source code which is developed to 
meet the principal gcal of this thesis. This program is also 
available in VAX/VMS public user account under file name 
eee lebNETS ECR", 


eee, 





: PROGRAM ETHERNET 
C ACTUAL RECEIVING OF MESSAGE. 
C SEND B820C< AEX NGWLEDGE “SGC .(end tyoe field=FF hex). 
C IF RECETVED BAD FRAME, DOD NOTHING BUT WAIT TO ®PECELY 
‘e Cre cCN ene i eloe Heeee ae ST FROM MAS SYSTE™“. 
E te, jew ee at Tom be, CALL YPLOAD. 
ic fe. Veen sis oe ') Cal OOWNLO4AD. 
character*23 NS, menecelve successfully. 
characterrk2& msao/’* Unreco3anized file tyoe. 
integerrke Vesmp lca tilt voe,exec 
integerr4 Systiume(c), tinel(2) 
integer*4d nichans, svsiqiow, sysibassian 
include Leora cu ness ySeinterlanl71cet.tor’ 
include PSO ae 
hyte 9ad( 190) 
nyte Poaceatt ls0),toaacxcet (155) 
byte AAO mGs) lene fi | Aaa tO, ff (5 } 
G Mocian of Chamne! -fo -!(20: 
10 PotpeiteasyGooaGcciran(: la0 251Cchan. + } 
twaiemojtaistat). call limtstoo(tya!] Cistsat )) 
e Peo hemue anidacdo. Om 1 re s 
fstat= Syseagiowl(,e¢¥al Cx1ichan), 
AvVallCioteset node .or. ios Cart uc), 
2 VOSDr + fee ere) 
IMINO ten) Stee Colwle | Vor storc 4ya 1c rst at )) 
Treroso cl). !t. 0) cal) Wee ee Chess Gl) 3 
c Receive incomina nessaqge:? 
150 tyoe *,' Ready to receive NesSateeccecee’ 
istatzsysSaiow(,4val€nichan), 
1 ZvalCiosereadilbik), 
é 10SDsr6% 
3 Poem eee ts, Ay a) C15)» ps5) 
leGemot estat.) if en 
hype ©, stat receive error’ 
sof Oo” 10 
end if 
PreCtech Clot. 00. tien 
CVE Ok yy ao recetyo error’ 
AOe Or 10 
eng 214 
Mt OSD Ce ees) then 
tyoe *,' Raceive olock CRO error' 
gJoto 10 
end if 
if€Ctosb(2).ea.2) then 
tyoe *,' Receive block aliannent earror' 
goto 10 
end if 
V4 (Closol2e)eea.4) then 
tvoe *,' “4issing receive olock' 
so eo 1 0 
eke fn ini 
it (Crosh Ce) easly) tren 
tyoe *,' DMA received block fail’ 
Giot oo 
end if 
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tyoe *,' Received successfully. 


Assign destination address: 
Saceet () j= 02" x 
leackeatce) = 07x 
taraiG co tees =  Ool ox 
Isacket C1 )= "00°" x 
Taaeket (5 )axroscketr (15) 
Toacket(6)=Roacket (16) 
Send acknowledge nessaaqe: 
Assian type field: 
Toacice ty.) = 0 0x wr poieatest hat §1t! 1S 95s messace 
foqe ketosis = Fr’ x ! acknowledge $1303] 


we) Behe Into transmit cacket: 


}- 

aie) me Re nt, 
Hee hs lew e Onsal (it) 
jrjt 

end do 


Transmit Oacket: 


istat=sysbaiow(,4Zval(raichan), 
1 “4Valliobewritelosl«), 
2 19OSO+re-. 
Sod meref(tToacket),%4val(1360),,,,) 
inf Caos 1) (2 0) seal me Ito ost oo tl Zyvai (i965 (1))) 
tyoe «,' Acknowl]2aqe Vs Hatmat Pansm) (tod «66 ee” 
Load transmit data and sen: 
NWotaqt=sSyvsna)ow ly 4val (na chan), 
1 4vallioeeltds), 
m4 WOSOes pars vor) 
fer Cabos ice) C0) Seal! | libbstoolaval Cioso(l))) 
iioOrosinGe einer) seal leliverstool.vallioso (Ce) )) 
has INCONMINa Nessare: 
,= 
Wi GtroaeweG(i)oeastenoar(  !°)).or- 
| (Roacket(i).eaq.ichar('w'))) then 
do ee oN Ce oe) 
7 = 1+ 
Stal pon Ve Po eR oacket (7) 
dfilnam(17*19)s=RoacKx«et (i) 
eno. Ad 
De Gistinmacwet (t=5)eeqa.,1charl’a)) 
1 2or.e(Roacket (i-3) ceacicnar('e£'))) 
2 LANG CGreac «et (1-2) seq-.ichar(l’o’ )) 
4 sOf. Weosceei (i 7c ).ce.1cnart{ 9) )) 
4 wane UU swoae<etC ts leg. 1cvar( a. )) 
5 er ey ee (moose ket (el jesea.i1cnact('C') si): tren 
exeG. = ‘2 i EUs e wee) i ite 
else 
eXiec= a) Gorter 32 ee. 4 lie 
end if 
sie i Bae | 
AG rte se ose ket Greene. 1charG’ ~*).) 
ft (n=1)=Roack=at (nm) 
n = ntl 


a5 





end do 
Vie@e@ttd Jeeaeichar('t')) or, 
1 Pit tUtpi.ea.t1ehar(’?T’))) then 
filtyoe = 1 
Slisenyt Ciel) sa.renar(’e )),or. 
Cae) Pec. renar( EE’ )) } oraen 
filtyoe = ec 
else 
call sendrsglroacket(15),"o0acket (15) .,7Ss20) 
Cyoe et, searecooni zed file tyoe.' 
aoro 1350 
end if 
else 
do gn eae cle Cbart 3) 
17 = 1+ 
ae) eke: 
108 ey : . 
write(6,11)(Roeacket();),1)2=19,1-1) 
PornvatG. ‘phe al) 
k« the request nessaae: 
f Ok osemeeul( | 7 )\eeasichar(*t*)) tren 
sfilnan(12-19)=0 
Ca ldown! catukoacket (ls). soacket (16j),511lman,; 
I filtyoe-,exec) 
Bilese)tGaoaewet (19) .eq@.ichart* 1')) tren 
dfilnam(i2-19)2=0 
G@allwue loadtvoaeter (15),Roacxet(l6),3filnam, 
filtvoe,exec 
end. t 
aqoro. 11 0 
end 
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MOON 


SUBROUTINE DOWNLOAD (Cr1I5-r16,sfilnam,filtyoe,2xec) 
ACTUAL TRANSFER FILEZTINTERACTIVE. 
RETRANSMITT SAME FRAME [TF NOT RECEIVE SRE CORE AGE Ah eS Sse Le. 
ABORT TRANSMISSION IF NOT RECFIVE ACKNONLEDGE IV 13 SEC, 
Characters2es nodes omsuch fibet Try vaqcalh. iy 
character*e3 reqdo7eensoort ITramsnission. ee 
integqer*e2 FosioCe actin, COUnt, done 
inteaerte filtvoe,exec, max 
inteaerrd Nnicnans sysSsaiows, SvyStassi IN 
int2ger*4d systhintim, svstsetinr, SsysS3waitfr 
integer*d Se ae eae (>) 
include “Capa <(9ossvseinterlaninidet.tfor ’ 
include "Chi 00ef )° 
byte ee mec ge eo rec Cl). s) 
byte teacxetClsG)y st tlaan (40 
byte POsoc cet (PSU )y rls, rio 
256/51, Thao cian ne to. “ah ts 
oat =—s eras sitoant. I140 7nichanr,, ) 
ai comers t at cal) 1 opstoot 4v-3)Cists6)) 


tyoe *,' Request transferring o f file’ 


Print filenane: 
Wrim@et oui. les fil mantle) px =1>7.15) 
LOR Wat «7 5a) ) 
PYOEm ws tom Woes ystem at -qagaress: 92 77.0 00"; 
ris, r1lo 
Assign destination address: 
Oaencet (Cl )Js Oe’ x 
ie acca be yao oy) x 
Novaigiee tt 50s ol 
Veacks © C4 = 760" x 
ete Nomaecress, oO reauest ina station: 
Toacket(S)eri5 
ieac t= t (o)l—rlo 
Reet ometvoo .f 1 ala: 
ioac eat, ) = OF x 
freaqewet.(8)= "00" x { first frame 


Initialize flaa: 
Sone = 


Seen tiie: 


Geen neate=cnl oan pum Ile =| soOroam) zeation= Sequent)4!i” 
l styoe='olidi',carriangecontroal='list’,errs9) 
Beet YOere nee kK CONT: 
at (fy 1tyoe.e@.1) then 
Goto. 50 
else 
Gots) 200 
enc ) f 


oe 





ais a) 


3 


iy 


nO suan 1 146 


1 
PE yeiaiaa lm 


Sac) 


[Gi ules ax 


Poem Tr lec error AS 
Calum senansa (rt 
tyoe *%, fo suc 
pO ae 


@ 


‘= 


AA 
= 8 dy 0 
_ Se ae = 
© VV -~ 
_ -W 
-t= — 
[be © 
t. _— 
a: wv 
» a od 
ia] a ee 
any) Ct 
- CT 2 
" L 
Tes Cr 
CO 
ore Cc— ab 


ao Nee” Se 


CO SQ 


UW « «x Kem mR Oem eR 
OC == 0 0 OU OD 0 @ 
“- it 22) So > OO oo 


i= COs eee 


 «& - 2 ~ 


a- — 
weed Se 
Nu O 


OO ae BA mie 
*- VUCNOodo 
ae WV AMINT EG 


Se MQ VYe> 


Oo 
a It 
me 
vec 


cou 


eQwreese 
ake we wh 
ws OW LW we 
Le, EUo 
48) qj 0 Ow 
a on0aw 


—r~ WN 
cr 
e ® 
~ ao 
—- C— 
oe Oe 
oT ae 0 
ao MN 
Nee’ Nene”? oe 
Of « 
nw « 
OO 
c=: = a) 
we 0) 
ee > 


Co wat he bee ee wee MIM tr tr 


33 
40 


De ro oe 

~ Cat Sen 
oO OO 
-~ = ° °@ 
CO - @ 
oo - — € 

oO ° @ 
wR No 
- —™ 
Ee > Net ee 
nw LOM ®, 
Cc il "nw 
Tw O90 
0 — = 
a7 bY Nee See 

WY + 


‘ce st) 
CO >— 
Ce — >o — 
—_ Ow 
WOEOL YO 
Tr € 
Cemnmeerm 
OC 4 ew 
O- OM 
POs Nw 
We We —W 
ee Nee 
i>empme 
— Ne Yw 
Hono 


for 
Secs 


"al r 
5 


nn om 
—-on~™ arr 
~~ ashe 
CT O 
ee De 
WEN 
r™ oo 8 2 me 
Ce ewe 
E— N— 
‘- O> OO 
~~ oY > 
ee (N>Pu>? 
a ed 
- WOO 
F.LOLO 
Ne west we 
co MW aN 
TM ete oh 
CIN [= C 
PO a 
GQ) eee — 
es O 
Cre a 
Toe > — 
CV’ ow 
TE ULC Q) 
— & 
TT wmaee ee 
CCMHYELY 
O-- OVUM 
OO & Nn we 
GTA NY) 
N Yee Now 
~» > 6 
IN Nw Ww 
wono 
Ce Cec 
Ow *-U e 
We te by 
wwe Nv 
POR ee oe et 
© 
= 


Ayvalliobereanlbol«), 
< 
$ 
> 


G,ival(a1 con); 


ve acknowledge 
=SVSd3010W 
S ) 
S ) 


et 
? 
’ 


“= UW) eS Me 


Dee TIM) ow oe 
@) 
q' 
8d 


rimers. 


a5 
frame 


hex ? 
cance] 
clear 
middle 


FE 
1 
! 
{ 


ify 


vat 


oo we We 
T ewe O™ 
me FC Ue 
Museo = 
ve lk wr mm 
se tae a Bi) hh 

e Orn eof 
ecoonmnt- 
QO Dis wm 
> @ UY eu 
ean >e Vec 
DODNOYC Orn 
Cur OT ODO 
Ce T~§ VY 
ov TU 0OfF 20 
ay of --e& O 


~ — 


a 

oO 

> 

ue 

od 

t. 

i. oe 

re 

Ce 

a 0 

year « 

tf 

in 

“_ > 

Ue a) 
e 

@ — 

C-— 

tae 

Ww’ UY 
Cc 
oa 
- © 
-=— & 
—d 

| @ 

C+ 
diew 


count +1 


aoto 40) 


count 


ling 


Sysowart frCzval(2)) 


end 
Cat 


98 


101 


190 


aac 


a5 


300 


400 


Ga ll esenamsoalrio,¢lo,nsa5) ean Ormt  Grans 7) SS Pom 
tyoe *, Short transnission. - 

ret uern 

eal t VT BSebon Cz Ves nos J) 


NSsigm value to messaqe of the last frame: 


MO. Ver, 150 


foaeketti) =" Sex P pilaak <cu1ar 
end do 
Tosca "PE ty la last f fate 
done = 
aqoto 40 
Send executable files 
i f exec.eqe.1) then 
readq(1,222,iostat=ios,end=5900,err=202) 
CSeqgqgreect iy i=l7 ole) 
fsematulotea.) 
maxes a4 > 
alse iflexec.en.c) then 
readies SoG tat =10S;,end= .00 perreaclec) 
| GSenmarec fj) j=l nieces) 
format (102431 ) 
Max .= 4 
end if 
k = | 
Sount= = 70%. 
doe | f= 7160) 248 
if Cexec.ea.!i) then 
Toacket(1+8) = sendrecl(«*1282( 123-1) ) 
else if (exec.ea.c) tren 
Toacket(1+3) = sendreci(«*1e28-(123-1)) 
end if 
end 26 
Istat=systaiow(,4val Cnicha: 
l CNS Cap Cl Ol eas 
2 1OSDs0, 
3 ; Moat tosgc~ret ) eave! ClS6),673) 
Inara sel). it. 0) call libsstoo(%val (ioso(l))) 
WHenescotle ome.) sear lIjoSsstool z4valliosol2))) 
CV oeet,. we “sere ioo t taeasmit ted... 
Load transmit data and send file: 
Wet st =SyVs baiowly4va Cnichsn), 
1 Z4ZvalCioeeltis), 
C ; YOSDrrerrvreee) 
ie iO eltw Os) GCa lot woes tomotzyal Ci osb( 1) )) 
i feleson-- newv)~calW lioststool.valliosotlc))) 
Yait for 15 seconds and abort: 
Sites tee Ss Vier mtave G0 aye lo. 7 tS) 
Vim ates tot reat)  liosst ool 7val () sit at }2 
istat=zsysitsetimr(4valle),~trefl(tine),,) 
lfeerateaStat) ‘cad )inpwetoeotsvallistat) } 
woyt (§2f 3 Seconn one ret ransnit: 
motsetescyvs tonmiynt: 0 reas > svst ime) 
itm Seat eesti laos too C7 yval(ist at )} 
IStee SY siiSste tinh oval Cl 4reteusystine)s,) ! wart for 
It emotes wot seal) “lies toot yo) (1Ss$tat)}) §$ S.isec. 


a 





C Receive acknowledae: 


VStatesysoaglonwt(, v9! (Cnichran) > 
1 aval liote Cae eae 
C INSDerer, 
3 Aref (Roacket),%val(1590),-,,) 
we Voge Giemet. CO) call In btstoo(tval Ciosa( th) )) 
ifCiosol(2).ne.0) call libistool(%val Cioso(2))) 
C Check the second tyoe field if = FF hex: 
fre tRoeeker lo )ceo. FE "x). then 
Cal -systeant inl, ) LC ance). tyregcs. 
Roa@exet(1&8)2°00°x lSeoreanm vac 
Iftlaone.ceaen) aoto 50 
VWoaacktet (a r= 01s x ni ao! s. feamne 
eos K+} 
1 (ken. max) then 
ASt one) 
else 
AOtaa >" 
end if 
end if 


Vio Ucounteme.c)ataen 
Calin SYS oWwal t Pret 2yeal( 1 )) 
count =counttl 


aotro 400 
end if 
Goal es vy Seon tar eve | be) 
call sendmsa(rl5,rio, ms 5 ) ViSaport tens ssion 
a cor Aport Rares ote 
etur 
202 Sea Ne miataerte a 1c ole) 
ie Assign value to message of the last frame: 
500 Go i=99 136 
loackce t. Ci )= 52 "% Y olank char 
end do 
VWoniewetun ja’ FE! x ; Vast? frame 
done = 
Bote 7400 
50 tvo2. *;,° Fransmit comoleseted’ 
close(Cunit=l) 
return 
end 
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MMOOAMAMN 


SUMO ete  IeLOnp (riS,rlo,afilnsam, filtyoe,exec) 

Coie eee tv tevG@ sor FLEE. 

SPSGaeD Last ex ast. 

Chiao On wien oeore) FTLE. 

SEND RACK ACKNOWLEDGE YSG.Cend tyne fielasFF nex). 

Pee eel vee see cae DO NAITATNG BUT wAlTT Tod “FUE TVE 

SAVE FRAME AGAIN, 
characterst23 msai/' Recaivad successfully. we 
enaracter*.cs “ey men ft) le fail! Irv again. / 
characterte4 Misioy obryoe —~seandfile FYLET™, 
integerr*2 ioso(e),done, filtyse,exec,nax 
inteaerrd nichans syssqiow, svstassian,recsize 
Vac lage Veg@ms ssl qesevs.interlan)inindef.for' 
include ‘ya ae ft) 
Divine Sacto), 5otrae( 512) weet erect (1.)24) 
byte Rese weel 1 50), ti ilnam(ap ) 
byte Meme. ot (loo, r 1.5, rio 

Assian a channel to S140; 
VStoac=Svyeness ont VIO ,atensany,s ) 
Wien ote iste) Call lye bstoot 4val(istrat )) 


Print. OU: a | 
type «,' Request receivina of file’ 


Ieint filenane: 
Whee Cov ecatylonant(k)}.<Sl,15) 
fOmeot. »losal 
(voewe, Strom D> Ssysten at adoress: O02 UF U1. OD", 
rid, rio 
iat! 12e et lags 
one=0 
Determine record size ov file tvoe: 
j Oly Ptvoe sed. |) ot nen 
reesize = 12 Pt ext of 1-he 
else if eaxec.eq.!) tnen 
recsize = 512 ' executanle file 
"max = > 
else if (exec.ea.c) ten 
mes i2e. = ie 4 eee wee, fle 
max = 9 


Joen new files: 
Ife ttwltyvoeseq.c) tnen 
ooen(name=afilnamn-eunit=2, 
Oraani2ationm= seaquenriag!’, 
(YVoe= "new ,carriscqecontrol="ist’, 


1 

e . e 

3 Voctoat=— tos ,ercr= 1, 
df 

e 


“ee 


PeG@omioeemaces | Zon recor itfvoes ti xeq™ ) 
ovuen(name=dfilnams,unitied, | 

\ oraanization='sequential', | 

é tyoe='new',-carriageconrral='list', 

3 jostat=ios,err=/7) 

a 
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20 


goto 90 

Cale semanms acer! >, Flo, nsac4 
tyoe *,' Unen neite any 
return 


Receive file: 
Cal Semanega( rl 57 Sih or ey noes ao 
tyocCws Wend instruction 
eg Ready. to receive fi 
k = 
IS St=Sy7sS sOlow (7 ovo) (ai chan), 
4valCiofereadini«), 


Need Nee ee Sa ee ae TF 
Tt ee ee!) 
pe pete Ce ee 


Ae) OIND— SIMO 


> 26s 
xz 


- message 
L acknowledae s1aqnal 


x 


Put oe ifto transmit oCackert: 


A = Bvess' 
fee et Vids Ne tor ens ol (1.12) 
jajt 

end “do 


Teoansmtt packet : 
istat=systaqiow(,tva plsial amy 


hewpite lol), 


foal CPS 6°) 4, 
toolazvalliosol 
BOO Pavia | oS ut 
GG OMe wre (al sei Oka) Beer ere ° 


Toss 


data and sen7: 

Saiowl,4val (nichan 

EVSat | vOoe ec] t- 
i 


Load 
} 
l 
e WO SOy-7 so 9 
} 
1 
} 


<3 
Ww =e 
writ 


ou oi) (ees oor 
. Gal |) “Weis © 
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lowe 


777 


666 


70 


| Cis bryos vem 
ite ( 


else if 


end if 


te 
We: 


else if 


end if 
Goto cv 


Med some (exec,ed.!)) then 
writ epe oo eaetreet jj), j=l, C1 e8* (eat) )>} 
ato 70 
done.eq.l) then 
aoto 7/0 
ecord every after receiving 4 or & franres: 
tyoe.eq.c) then 
ao l=, es 
if (exec.2ael) then 
Seurecu<= fao0-Cl2o—1))=sRoacket ()+1s) 
else if (exec.egq.c) then 
Getrec a. © 1en—f 123=1))=Resacket ()] +14) 
end if 
end do 
k = kt 
Tp eee. Tot ren 
1f (exac.eq.!l) then 
Weiter, FDO) oetree (35), j)=lsrecsi ze) 
focmat (5 lest) 
else if (exec.ea.ec) then 
wreivtel(e,//7/)laetrec!](j))5)=!l, recsi ze) 
format (idcdal ) 
end if 
| 
end if 
Cfyityoe.2q.!) then 
Aree e, ooo) (oac<et(j)717=17, 146) 
format(!?8al) 


ellose (un Cac) 


tyoe *, 
cca 6 Vilas 
end 


Receive comoleted!'! 
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AIMAAA”AN 


SUBROUTINE SENDMSG(r15,r16,ms0) 
ACTUAL SENDING OF MESSAGE. 
NATIT FOR ACKNOWLEDG E 
IF NOT ACKNONLEDGE IN S SEC, RPETRPANSYVIT 
CeO ete JO4IREDSE TN 10 SEC, ABORT TRANSMISSTON. 
eharactenr*(*) NSQ 
Inteaerr*2 Toso l(c), addr,done,count 
mNteaerr4 Aleman, 5a Sn sysfassian 
Inteaer*d Sysbointin, svyvsisetiner, sysSwaitfr 
inteaer*yd systinel(e),time(ce) 
include "eadralsinossvs.intertan)lnidef.for' 
include "(Siodef)' 
byte oad(100) 
nyte toaenet (loo), text l2o) ,<oacket (150) 
byte els, ris 
OSs ion. 2a. €nranmel to ILA.U: 
PStat=svsoassion€ Viadana cranes) 
it Cee ote iGmobeiG a1) Ie cs toot 4.y5 1 (istat)) 
Assign destination address: 
ieaeget Cl) =. 02" x 
tipackset (2)=°O7" x 
Weac cet (5 3= 0" x 
Weoe cet Cao = 010 x 
hogenw st CS =f 15 
Toacket(6)=erlo 
Assiaqn tyoe field: 
Toaciaet (7)='00"x ' nessaae 
feaare oe tam se x a Jom, ty ca ce 


Put eet THtoOuthonsm)t woOocKker: 


ale t=) pe 
Toa eS =Jenort(msaql( 1217) 
j=} . 

eno ao 
Transmit packets: 

Coumt =0 

Istatssyvstaiowl(,Avali(nichan), 

1 FV IN CCR A a ee 

2 1OSDre-r 

Se met (rose wet) 7 iValCi so) +757) 

Wivtrosm (lbs iti0) Jead | epee en | O80 Td) 8 

Pri Voshlelne.0) e¢3)) lnGtstoot 24: (16s0(2))) 

fyoe *s Wescsaqe 16 642174 re ee 
Load tfansmit data and seni: 

1stat=syssaqiowl(,ival (nichan), 

{ “ZVat(1oeel] tds), 

2 YWSOrerrereee) 

Pm iose (leit . Osea! lionstoct(4yel (Tioss (1) )} 

tre tocme Ccleme. 0) Call bibistool 4yvail(ioseo le) )) 
MoCo lo Seconds Soda soo rt : 

Gate svysuoimtyne ’ oO 2295.0", t ime) 
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Galt svstsetinr(4val le), s4ref(tine),7) 


Vai Getor 5 second amd retransnit > 
atone y Ss benim: ia, 08 25.0 >,S5yst ine) 
call svsisetimr(%val(l), met Csvstime) 07) Mpeppams ant 
LA ar > SFC 
Recel ve acknowledae: 
ean) 


Wstat=sy¥sbavourr va tn) 
! “valCiofereadlole), 
C 19OSDss, 
3 : A6ef CacacKket), 4Val (C150) py7s) 
Mec loso Cl) wits) cat! luetetool4val Cioso(?)))) 
WieGtosoue ) eq 0) call  liintstootival (ioso(2))) 
Gece (he seconma tyoe field af = FF hex: 
if ens es eer then 
} = 
do SR eager cS PCN Ne 
eas os 
Sm) Go 
weite oy, oo)}(noac cet (j) Ji, 17=19,1-1) 
Pormmat te 2 5 61> 4 10) 
Gal leesvsS scamtimt » ‘) cance! timers 
Foeacket(18)5s'00'°'x 
return 
end if 


it Ceount.nemem then 
Gal svsmmworrrre4yai())) 
eount=Ccoumt +] 


‘olen age. 
ena if 
Galilee yvicunwaittrizval (2)) 
Pet urA 
end 
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EDHRESNEE 2S 4a Pregrem that will allow an individual tc 
transfer a message cr a file between VAX/VMS and the MDS 
System. After this program is executed on one of the VAX/VMS 
terminals, a user can leave the terminal and operate only on 
the MCS System terminal until he wants to disconnect the 
communicaticn. 

The user can execute this program only when he has 
LOG IC privilege. If any problems occur while executing the 


rrogran, user can contact one of the following VAX/VMS 


Peoressicnal staff: 


Albperc Won d,s SpD05,°-x2455 
Olive Paek, S$p525b 
Jeanne Bowers, Sp525a, x2168. 


SPECIFIC: 
ETHERNET.EXE program resides cn the VAX/VMS under public 
user acccunt with user name “INTERLAN" and ovoassword "VMS". 


Any user can copy this file by typing in the fellewing 


commands: 


$Copy <CR> 
SFrcms _dzal:s(interlanjethernet.exe <CR> 
B10; * <CR> 


The user snould alse copy £lie ETHER1.EXS which should 
be executed after finishing the file transfer process in 


ecrder te clear both transmit and recsive buffers. 
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When these two files are copied, user can execute 
ETHERNET. EXE by typing 


fr ethernet <CR> 
then the message 
Ready to receive message...... 


will appear cn the screen which talis the user that VAX/VMS 
has keen cennected to the Ethernet Local Area Network. 
After chis point the user can do any file orf aessage 


transfer Ey working cn the MDS Svstem terminal. 


e€ time this thesis is being written, there are 2 
diskettes which contain program used to do file and message 
transfer between MDS System and VAX/VMS, one diskette is to 
be used with the MDS System which is connected to the single 


density disk drive and it contains the following programs: 


LOGON1.COM 
SEN DMSGT.COM 
SENDFIL?. COM 


the cther is to be used with the MDS System which is 
connected te the dcuble density disk drive and it contains 


the fcllcwing programs: 


LOGON2.COM 
DENDHSG2.CcoM 
SNOT Ee CON, 


These <twe diskettes are now being used by Capt. Mark Stctzéer 
USNC , *he originatcr of the programs inthe diske«+tes. 
Therefore, the final instructions on how to use the programs 
will be found in his thesis which will be completed by 


September 1°83. However, the instructions on how to trars- 
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fers file cr messages between the MDS System and VAX/VMS are 
as £cliows: 
When the system is booted up with the above mentioned 


diskette, execute LOGCNI1.COM (or LOGON2.COM if you work with 
the dcuble density disk drive) by typing 


A>LOGONT <CRD> 





ETHERNET CONSOLE MESSAGE TRANSHIT PROGRAM: 
VERON te ti SINGER UE Nor TY s 06 /10/53=4DS 


NCTESPRCGRAM "LCGON1" MUST BE LOADED PRIOR TO 
RUNNING THIS PRCGRAM FCR FROPER OPERATION. 

IF NCT-COLD BOOT AND TYPE "LOGON1" AND 

SOEN INVOKE THIS FROGRAN. 


SELECT NET ADDRESS OF DESTINATION: 
ADDRESS 00-04-0A( MDS SYSTEM ):ENTER 1 
ADDRESS 00-03-EA( MDS SYSTEM ): ENTER 
ADDRESS 00-07-7F( VAX 11/780 ):ENTER 


3 


INPUT MESSAGE (128 CHAR MAX)-END WITH ACCENT=> * 


ranstit a file Efrem your A disk to VAX/VMS: 
SG lik2 you want to transmit a& message as 
n 


é you must enter the special nessaaq¢ as 
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mNEUT MESSAGE (123 CHAR MAK) —-END WITH ACCENT=> *% 


wt ee Aka RECEIVED MESSAGE Is: 
ieee Sena: ie eNs Er 


RHEKEKEEKEK END CF MESSAGE 
SGNNEC TVD STO THE ETHERNGT*COLD BOOT TO DISCONNECT 


AD>DSENDFIL1 filename. filetype <CR> 
ETHERNET FILE TRANSFER PROGRA®: 
VERSION 1.12-SINGLE DENSITY : 06/10/83-MDS 


NOTESFCR PROPER OPERATION, PROGRAM "LOGONI" 
MUST BE EXECUTED FIRST TO LOAD THE INTERRUPT 
HANDLER INTO MEMORY. IF NOT-COLD BOOT AND DO SO 


SreecioNet ADDRESS OF DESTINATION: 


ADDRESS Q00-O4-0A (MDS SYSTEM):ENTER 1 
BODRNSS CO-O03-EA (ADS SYSTEM) SENTER 2 
ADDRESS 00-O7-7F (VAX 11/789) :ENTER 3 


IS THIS A TEXT FILE [52.5KB MAX] ( Y OR N) ==> 
Y 

REACLING THE FILE INTO THE BUFFER... 

REAL CCMPLETE 

HO He KK FILE TRANSFER BEGINS ¥*®*®**% KX KX 

TX 
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PHEAZASECE PILE TRANSFER COMPLETED *#EAStE4 Et 


X/VNS to your disk: 
Want tO transmit a messaqde as 


St enter the special message as 


INPUT MESSAGE(128 CHAR MAX) ~END WITH ACCENT=> *% 


ifilename.filetype/e xe’ 


eee eeee ee FILE RECEIET BEGINS *****4*x xx 
CPENING RECEIVE FILE: RECFROMX.NET 

RX 

RX 


® 
eeee* END FILE RECEIFI-SEE FILE RECFROMX.NET #***x 
CONNECIED TC THE ETHERNET-COLD BOOT TO DISCONNECT 


A> 


Note: Except for line spacing, the above sequences appear as 
they will at the MDS System terminal. The underlined items 


are these which you must enter (in proper sequence). 
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Important ncte: 


1)De not forget to end any message sent to 


Meech accent "se, 
2) Sie cc 


transferred 


the 


is used 


to indicate that 
The 
the file to be transferred is an 2xecutable 


is used 


IS a tOmt Elis; "/oxel 


that 


must specify Ciscoe Hou cato s GQOErectLy ‘£0 


successful transferrirg of a file. 


the VAX/SVMS 


APPENDIX 5 
SYMBOLIC NAME FOR NI1010 CONTROLLER COMMAND CODE 


This Appendix lists all NIDRIVER QIO function codes. The 
NI1010 Ethernet Controller User Manual contains a complete 
description £ the NI1010 controller command codes and 


x 


status returns. 
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SO 


APPENDIX £ 
NIDRIVER FUNCTION AND STATUS CODE SUMMARY 


Ros Apeendix ists all eNIDEEVER QIO function ccedes and 
IOSB status codes for each. The list of IOSB status does not 
include standard VAX/VMS error codes for device-independéent 
errors. 

The NI1010 Ethernet Controller User Manual contains a 
complete description cf the NI1010 controller command codas 


and status returns. 





Ssymbelic Controlier Function Possible Contents of 

Function pecondgrosse Longword 

Codé li status is 
SSS_NORMAL(Iin octal) 

IO$ SETMODE! Go Online 0 

hore STARTUP 

Pere orTNCLE! Go Offline 0 

IOSM SHUTDOWN 

IO$_RKEADLELK Supply Receive BUffeEr meee note 744 

TOS READEBLK Sl Receive Buffer QO(see@ note 1),17 

IO$_WRITELBLK Load Transmit Data and Send Ot leis Oo OeelOs Vy 

IOS _WHRITEFBLK Load Transmit Data and Send Or 3 Oe 1 O57 

ieee SaTLM Ser Module Interface Loopback ; 

nods 

omer LLM Set Internal loopback Mode Q 

Heme Cis Clear LIcopback Mode | 0 

ime OER Ml Set Premiscuous keceive Mode 0 

POSS CERM Clear Fromiscuous Receive Mode Q 

20m SEOLM Set receive-On-Error Mode 0 

moma cChors Clear kéeceive-On-Error Mode 0 

IO__ OFFLINE Go Offline 0 

BOSS CNLINE Go Online 0 

IO__ ROBD RUN Op—boatd Diagnostics. See note 2 

Ee@enkS ReEPOrTe ana Reser StavlSe.cs 0,17 

pomeen CDT Report Collision Delay Tine ES 

Lema > HB eee Receive Buffer QO (see note 1),17 

ieee LID Load Ttansmit Data OF 5457 

Boee LIDS Load Transmit Data end Send OOo es ip OF 10, le 

IO__ LGA Loed Grcup Address (és) De ig ie gle. 

pom GA Delete group Address(és) OFS 0 2e 17 

IO__FEBC Flush receive BAR/BCK Queue 0 

ite n ESET Reset See note 2 

note 1: The STATUS bytes of a received packet will contain 

ncne OF mOre of the following octal error codés: 


1 CRC “error 
alignment 


y error 
4 1 or more packets were previcusly missed 
ola am 


Airy 


Dee Woed: ‘COMcad fh 
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17 Non-existent MEY, timeout on some Ltuffer 
wocds(OcneL than whe Eirst) oeccurced ghile 
DMAing the received packet into memory 


The second IOS 
Senta md wa Ins 
diagnostic cod 


note 2 cngword at the se Sa Of nas 


Bae . 
ontain ene of the following 
es; 


success 
checksum error in local memory 
NM10 DMA error 

<ransmitter error 

receiver error 

loopktack failure 


MEWh=OS 


ils) 
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